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INTRODUCTION TO RTX 


This section presents an overview of Computer Automation's Real-Time Executive (RTX) 
program which operates on the ALPHA-16, LSI-2, and LSI-305 processors. The following 
discussion is concerned with three basic questions: 

1. What is RTX? 

2. When should RTX be used? 

3. What does an application program look like? 

1.1 WHAT IS RTX? 

RTX is a modular package of service routines that handles both the overhead functions 
and the scheduling services associated with a real-time environment. Modular con¬ 
struction allows you to select only the portions of RTX required for your application. 
Real-time environment means that if your application requires that certain tasks be 
performed at selected intervals or in response to an external signal or event, then 
RTX will manage the orderly interruption and resumption of your program. RTX does 
all the overhead functions to maintain and direct the execution of your application 
during both normal and real-time processing. 

RTX is also a powerful multi-task executive that controls all tasks of the overall 
application. These tasks include priority scheduling, response and assignment, 
interrupt servicing, and communication among RTX tasks and user-developed handlers. 
Overall task control: 

1. Allows the application program to be designed as a number of either inter-related 
or subordinate tasks. The nature of the application determines the task relation¬ 
ships. RTX will completely handle the switching from task to task as required. 

2. Allows the application program to dynamically define (and redefine) the priority 
level of the various tasks in the application using RTX service routines. This 
is a software priority which is then used by the RTX scheduler function to direct 
the sequence of task execution. 

3. Allows RTX priority scheduling, response and assignment to share the computer 
among tasks with equal priority. When all tasks of the highest priority are 
temporarily waiting for some event to occur, the next highest priority level is 
scheduled in the same manner. 

4. Allows response to interrupts, as generated, because the user provides the 
interrupt instructions which transfer control to an interrupt service routine. 
This interrupt service routine will save status (using an RTX function), perform 
the necessary instructions to assure no data loss, and then restore status (using 
an RTX function). This routine can also cause a lower priority routine to be 
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scheduled if additional processing of the interrupt data is required? the lower 
priority routine can be temporarily deferred until any higher priority tasks have 
had their turn at executing. 

5. Allows the various tasks in the application to communicate between themselves (or 
with RTX) through RTX communication routines. These routines allow a task to 
uniquely identify the communication request and then post it. Posting consists 
of presenting information to, or requesting information from, another task. This 
facility may be used to operate simply as a signaling device, or it may be as 
complex as both a signaling and parametric (pointer-passing) function. 

All of these RTX features combine to produce a multi-tasking, real-time scheduling 
executive that is, despite its small size, the most powerful and easy to use system 
of its kind on the market. Figure 1-1 illustrates a typical example of RTX. 


1.2 WHEN SHOULD RTX BE USED? 

The most significant reason for using RTX is that your application program requires a 
real-time environment. Real-time environments are found in many circumstances, 
varying from high speed data acquisition to occasional sampling of an electro¬ 
mechanical device such as a relay. The basic criterion is that a need exists for the 
a PPiication to communicate with some external device or event in a time-dependent 
manner. If this criterion is met, then RTX is a suitable vehicle for defining the 
relationship between the external device or event and the application programming 
tasks which control and service that device or event. Some of the more obvious 
applications are: 

1. Communications 

Message Switching 
Store-and-Forward 
Networks 

Reservation Systems 

2. Process Control 

Plant Operations 
Flow Monitoring 
Equipment Direction 
X-Y Positioning 
Petro-chemical Applications 

3. Data Acquisition 

Test cells, such as automotive or airframe/aircraft 

Traffic Control 

Instrumentation Control 

Source Data Entry 

Oil Field Data Monitoring 

4. Medical Data Processing 

EKG/EEG Analysis 
Patient Monitoring 
Cardiac Monitoring 
Patient Billing 
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5. Security Systems 

Plant/Facility Security 
X-Ray Security Systems 
Video Transmission Systems 

6. Financial Transactions 

Point-of-Sale 
Automatic Banking 
Inventory Control 



1.3 WHAT DOES AN APPLICATION PROGRAM LOOK LIKE? 

RTX allows the user to construct his application in modules. These modules are then 
combined with RTX during the loading process to produce the final application program. 
The user may choose any arrangement of his program into modules that suit his needs. 
Figure 1-1 shows a general diagram of this type of arrangement. This modularity 
concept applies not only to the user's application, but also to RTX itself. The RTX 
package is simply a library of separate subroutines which may be referenced by the 
user's modules; certain of the RTX subroutines in turn reference others, and the 
linking of all required modules (performed by the LAMBDA loader or by the OS :LNK 
program) results in a configuration consisting of only those modules needed for the 
application. Figure 1-2 shows how the modules and user programs are loaded into 
memory and the size of the individual RTX modules. Keep iit mind that the only RTX 
modules actually loaded for a given program will be the ones required by the 
particular program. 


1.4 DEFINITIONS 

1. Activity: A task which has been initialized (via BEGIN: for example) and is 
receiving support from RTX. 

2. Common Subroutines: Subroutines which may be used by two or more different 
activities concurrently. These require special coding to provide reentrant 
capability. 

3. Coordination Number: A decimal integer used to identify a task to RTX. It is 
analagous to a telephone number in that it is used to "connect” a task to another 
task or to the DELAY: process. 

4. Interrupt Data Processing: That portion of code that processes the data obtained 
by an Interrupt Service routine. 

5. Interrupt Service: That portion of code that must be executed immediately after 
the interrupt occurs (so as not to lose data) . It should be limited to only that 
code which is necessary to assure no data loss. 

6. Inter-Task Coordination: A method for tasks to communicate and pass parameters 
using two 16-bit computer words. These words may contain any information, such 
as a table address, a pointer to a list of values, or a value itself. 
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Communications Task 


J _ Peripheral Device Task 

Additional Communication AND 
Peripheral Device Tasks as 
needed 


(2) CAI-Supplied Tasks 
(IOX) 


File Manager 


Task 1 


Task n 


(3) User-written Application 
Tasks (as many as 
needed) 


(1) RTX Nucleus provides control, scheduling, priority handling. 

(2) CAI-supplied tasks provide handlers for I/O (such as printers, tapes, 
etc.,), for communications (such as BISYNC, ASYNC, etc.), and others. 

(3) The user need only supply tasks which perform his application's work, 
while utilizing the CAI-supplied software for support. 


Figure 1-1. Typical Example of RTX 
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ADDRESS 
: 0000 


:00FF 


: nFFF 


MEMORY 


Literals and Interrupts 


User - Mainline (i.e., RTX 
Initialization), Tasks, 
Data/Work Areas and 
Interrupt Service Routines 


IPX - TTY, Line Printer, 
CRT and Paper Tape 
Tables and Drivers 


IPX - Card Reader and 
Mag Tape 

Tables and Drivers 


IPX - Disk 
Tables and Drivers 


IPX Scheduler 


RTX Nucleus 
RTX:, BEGIN:, END:, 
List Pinters and 
Scheduler 


Debug (ZBG) 


IPX Controls 
IONIT:, EOR:, EOF:, 

SIO:, . . ., SINT:, 10: 

and EOFCK: 


RTX Services 

DECPR:, DELAY:, GET:, PUT:, 
. . SUBR:, SUBX:, INTG: 
and RTOSZ: 


File Manager 


MODULE SIZE 

T 


Scratch Pad = :100 


User Programs 


: 200 + 


: 180+ 


: 260+ 


: A0 

I 


: CO 


: 2D4 


: 290 


: 130 


: 600 

'r 


RTX/IOX Library 
Segment 1 


RTX/IOX Library 
Segment 2 


Figure 1-2. RTX Software Configuration 
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7. M^ain Line: A short initializing sequence which resets all task table pointers, 
and then begins one or more tasks. (Tasks may also be begun by other tasks, or 
upon an interrupt from an external device.) 

8. Priority: A software defined method for assigning (and re-assigning) the rela¬ 
tive importance of a task to RTX. 

9. Re-entrant Programs: A program specifically written such that it may be directly 
entered by more than one program, concurrently. Under RTX, this is necessary 
only if two or more Interrupt Service routines require immediate use of the same 
program. For example. Interrupt Service A calls routine C. While C is executing. 
Interrupt Service B becomes active and also calls routine C. If C were not re¬ 
entrant, this second call to C would replace the return address at C's entry 

' point, causing the return address for routine A to be lost. 

10. Task: A program or set of programs which operate to perform a specific function 
within the real-time application. 

11. Work Area: An area of storage dedicated to table space for RTX. This table 
contains all the necessary information for RTX to perform its functions. Its 
usage is dynamic and is dependent upon the maximum concurrent usage of RTX 
functions. 
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SECTION 2 
RTX ORGANIZATION 


RTX is basically a collection of functions (subroutines) and a user-supplied work 
area, which are linked to the user's Mainline sequence and tasks prior to execution. 
Each RTX function may be called as a subroutine by the user as it is needed, to 
perform a specific job. (See below for descriptions and. calling sequences of these 
functions.) RTX also includes a task scheduler (SCHED:) which is used to execute the 
task of highest priority. The priority of a task is defined when the task is begun, 
and may be changed by the task, using the SETPR:, INCPR:, and DECPR: functions. 
Priorities may range from 1 to 8191, with larger numbers representing the higher 
priority. 

The scheduler maintains a "Ready" list of each task in order of priority. The highest 
priority task is executed until it suspends itself by calling any of the following 
RTX functions: 

DELAY: (unless altering or cancelling a previous delay) 

GET: (if no corresponding PUT: yet, and not a cancel call) 

SUBR: (if the common subroutine is busy) 

PAUSE: (essentially reschedules the pausing task at the same priority) 

10: (BEGINS, at I/O completion time, the normal or abnormal return at the 

same priority) 

SETPR: (if the new priority is lower than that of another task) 

DECPR: (if the new priority is lower than that of another task) 

Once the task has been suspended, RTX executes the new highest priority task. The 
rule for determining the highest of equal priority tasks is, "first in - first out". 
Thus, if a task suspends itself, it thereby becomes "last in" within its priority. 

In addition to the user-invoked suspends listed above, occurrence of an interrupt 
will cause a task to be suspended, if the new priority is higher than that of the 
current task. An interrupt is defined to be: 

1. A hardware (external) interrupt, with INTQ: or INTAC: attached, or 

2. A software (internal) interrupt: 

a DELAY: expiring 

a PUT: which satisfies an outstanding GET: 

a SUBX, UNLK:, or UNPR:, with a higher priority task waiting 
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In addition, an Input Output Executive package (IOX) is available, which may be 

linked to run in conjunction with RTX. Its function is to perform I/O operations to 

the standard CAI I/O devices (teletype, high speed paper tape reader and punch, card 

reader, magnetic tape units, and disk) and resolve confilicts of concurrent I/O 

utilization. 

A File Manager operates in conjunction with IOX. It enables the user to communicate 
with data files by name, independent of the physical medium storing the file. 

Requests for access are made through IOX using Logical Units (LUNs). 

2.1 WORK AREA (USER BLOCKS) 

The user must supply a contiguous work area for RTX to build its tables. The address 
and length of this work area is specified in the call to the RTX: function. It is 
grouped by RTX into blocks of five words each, and there must be at least two of 
these blocks (10 words) reserved; otherwise an error return will be made from the 
initialization routine. Table 2-1 gives a list of the RTX functions which allocate 
and de-allocate this area. The left hand column denotes the number of blocks allo¬ 
cated (+) or de-allocated (-) by the function in the right-hand column. The user 
must supply sufficient work area for the maximum number of five-word blocks which 
may be allocated at any one time- 


2.2 RTX FUNCTIONS: 

2.2.1 Initialize Work Area (RTX:) 
Calling Sequence: 


N 

WKAREA 


EQU 

(NUMBER OF 

TASK BLOCKS) 

RES 

N+N+N+N+N, 

0 AREA FOR BLOCKS 

JST 

RTX: 


DATA 

N 

# OF CONCURRENT ACTIVITIES 

DATA 

WKAREA 


ERROR 

RETURN 

WORK AREA EXCEEDED 

NORMAL 

RETURN 



Returns With: 


INTERRUPTS ENABLED 
OVERFLOW RESET 
WORD MODE 

A REGISTER CURRENT RTX REVISION NUMBER IN ASCII 

X REGISTER CURRENT RTX REVISION NUMBER IN ASCII 

This subroutine is called in the user's Mainline sequence to initialize the working 
area of RTX. The work area is broken into N blocks of five words each, which are 
then used by the remainder of RTX during system operation. The number N must be 
large enough to allow for all concurrent activities. Work area overflow will cause a 
jump to the RTX: routine's error return at any subsequent time during the running of 
the program, not just during the call to RTX:. 


m 
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I NOTE I 

A call to this subroutine causes activation of the RTX Scheduler. 

Upon return, the calling program (normally the user's Mainline 
sequence) is thenceforth considered a task with a priority of 8172. 

In addition to initializing the work area, the RTX: subroutine can also reset all I/O 
tables, if desired; this feature will insure restartability of a user's program. The 
feature may be referenced in the user program, if restart capability is required? 
otherwise it may be omitted, thereby shortening the overall length of the program. 
(Upon initial loading, I/O reset is not required before execution.) 

To include this feature in the RTX: subroutine, simply reference the module "IONIT:" 
in the Mainline sequence; either of the following directives: 

IONIT: REF 
or 

LOAD IONIT: 

will serve this purpose. 


2.2.2 Initiate New Task (BEGIN:) 

Calling Sequence: 

JST BEGIN: 

DATA (*) START ADDRESS OF NEW TASK 

DATA PRIORITY OF NEW TASK 

Returns With: 


INTERRUPTS - ENABLED 

OV-UNCHANGED 

A REGISTER - UNCHANGED 

X REGISTER - UNCHANGED 


NOTE 


When the new task starts executing, the A and X registers will 
contain the values at the time of the JST to BEGIN:, OV will be 
reset, and the computer will be in word mode. 

This subroutine is called to initiate a new task. The task is scheduled and BEGIN: 
then exits to the task Scheduler. This means that the calling program will not 
receive control back immediately if the new ("begun") activity is of higher priority, 
or if another task of higher priority is ready to begin execution. 
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Table 2-1. User Blocks for RTX Functions 

__ Function _ 

RTX: 

BEGIN: 

END: 

PAUSE: 

PUT: (If a new, unique PUT: and no corresponding GET: is waiting 
for it) 

PUT: (If a new unique PUT: and the corresponding GET: is already 
waiting for it) 

PUT: (To change the information in a previous PUT:) 

PUT: (To cancel an outstanding PUT:) 

GET: (If a new, unique GET: and no corresponding PUT: is waiting 
for it) 

GET: (If a new, unique GET:, and the corresponding PUT: is already 
waiting for it) 

GET: (To replace a previous task currently waiting for a PUT: 
with the current task? the new GET: must be called with the 
same coordination number as the task to be replaced) 

GET: (To cancel an outstanding GET:) 

DELAY: (To initiate a new delay) 

DF T AY: (To change the length of an outstanding delay) 

DELAY: (To cancel an outstanding delay) 

INTSV: 

INTRS: 

INTAC: 

INTQ: 

SUBR: (If the common subroutine is not already in use) 

SUBR: (If the common subroutine is already in use) 
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Table 2-1. User Blocks For RTX Functions (Continued) 


No. of 

Blocks 

Function 

-1 

SUBX: (If no other tasks are waiting to use the common sub¬ 
routine) 

0 

SUBX: (If one or more tasks are waiting to use the common sub- 


routine) 

+1 

PROT: (If the facility is not already protected) 

0 

PROT: (If the facility is already protected) 

-1 

UNPR: (If no other tasks are waiting to protect the facility) 

0 

UNPR: (If one or more tasks are waiting to protect the facility) 

+1 

LOCK: (If the facility is not already locked) 

0 

LOCK: (If the facility is already locked) 

-1 

UNLK: (If no other tasks are waiting to LOCK: the facility) 

-1 

ABORT: (In addition, -1 for each resultant SUBX: call where no 

other tasks are waiting to use the common subroutine, and -1 for 
each resultant UNPR: and UNLK: call where no other tasks are 
waiting to PROT: or LOCK: the facility) 

0 

GETPR: 

0 

SETPR: 

0 

INCPR: 

0 

DECPR: 

0 

IOREL: 

0 

IOWAT: 

3 or 4 

10: (as follows:) 

+1 For the immediate return +1 For setting a watchdog timer 
+1 For scheduling +1 if i/o completes before 

scheduling completes 
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NOTE 


Priorities are integers ffom 0 (lowest) to 8191 (highest). Users 
should limit priority to less than 7000 because certain RTX functions 
use those of 7000 and higher. 


2.2.3 Terminate Current Task (END:) 

Calling Sequence: 

JST END: 

The current task may terminate itself with a call to END:. No arguments are required 
and control will not return. 


NOTE 


The Mainline sequence (as a result of the JST to RTX:) has a priority 
of 8172. This sequence should begin other necessary tasks and then 
terminate itself by a call to END:. If it does not terminate, no 
tasks of a lower priority can execute. 


2.2.4 Suspend Current Task (PAUSE:) 

Calling Sequence: 

JST PAUSE: 

Returns With: 

INTERRUPTS - ENABLED 

STATUS - UNCHANGED 

A REGISTER - UNCHANGED 

X REGISTER - UNCHANGED 

This subroutine is called by a progtam which desires to allow other tasks at the same 
priority level to got service. This is useful if a program is unusually long or is a 
closed loop. PAUSE: is essentially similar to a BEGIN:, END: pair, but is less de¬ 
manding on work area space in RTX. 



Programs which loop indefinitely are permissible, but should be used 
carefully since they will block execution of all activities of a 
lower priority. Tasks should begin in response to a stimulus, 
generate the appropriate reaction, and end. 
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2.2.5 Coordination Numbers 


Before discussing GET:, PUT:, and DELAY: the concept of coordination number must be 
understood. A coordination number is a 16-bit value which is supplied as an argument 
to GET:, PUT:, DELAY:, PROT:, UNPR:, LOCK:, UNLK:, 10: and IOREL:. This number 
serves to identify the activity 50 that it may be referenced by a later call. 

For GET:, PUT: AND DELAY:, the same coordination number used in the same type of call 
supersedes the previous call. The negative (2's complement) of a coordination 
number cancels the previous call. FORTRAN uses the following coordination numbers, 
and the designer should avoid their re-use: 

F:RBPG address (for LOCK:) 

:FFDC (for LOCK:) 

In addition, all DELAYS performed in IOX and COMX use memory addresses as coordination 
numbers. These memory addresses fall within the IOX or COMX boundaries, or their 
associated tables (CIB's) . Thus, it is strongly suggested that the system designer 
follow this practice, and use as coordination numbers, only memory addresses of 
locations within his program. Basically, it is the system designer’s responsibility 
to allocate coordination numbers so that no conflicts arise. 


I WOTi I 

Zero has no separate identifiable two's complement, and therefore a 
coordination number of zero should not be used. 

2.2.6 Inter Task Coordination (PUT:/GET:) 

These two facilities are generally used together as a pair. In general, PUT: passes 
32 bits (the A and X registers) to a GET:. Coordination numbers are used to insure 
proper reference. There are no timing restrictions on associated PUT:/GET: pairs. 
(If a task calls GET: before another task has made the corresponding PUT: call, the 
GETting task will suspend until the PUT: is made.) 

PUT: 


Calling Sequence: 

JST PUT: 

DATA COORDINATION NUMBER 

Returns With: 

INTERRUPTS - ENABLED 

STATUS - UNCHANGED 

A REGISTER - UNCHANGED 

X REGISTER - UNCHANGED 

This subroutine is called to do one of three things: 

1. Pass 32 bits to another task; call PUT: with the same (positive) coordination 
number which will be used in the call to GET; 
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Change the information in a previous PUT: 
number used previously. 


call PUT: with the same coordination 


3. 


Delete an outstanding PUT:? call PUT: with the 2’s complement of the coordination 
number of the PUT: to be deleted. 


| NOTE 

If a PUT: is issued before the associated GET: is called, one block 
is used from the work area in RTX. If the GET: is called first no 
additional demands are made on the work area. 


GET: 


Calling Sequence: 

JST GET: 

DATA COORDINATION NUMBER 


Returns With: 

INTERRUPTS - ENABLED 

STATUS - UNCHANGED 

A REGISTER-FROM ASSOCIATED PUT 

X REGISTER-FROM ASSOCIATED PUT 

This subroutine is called for one of three reasons: 

1. To obtain 32 bits (A and X registers) from another task: call GET: with the 
positive coordination number to be used with PUT:. 

2. To delete a task currently in a GET: waiting for the associated PUT:? call GET: 
with the 2*s complement of the coordination number. 

3. To replace a task currently waiting for a PUT: with the current task? call GET: 
with the same coordination number as the task to be replaced. 

After GET: is called, control will not be returned until the associated PUT: is 
issued. 


2.2.7 Delay Current Task (DELAY:) (Requires Real-Time Clock Option) 
Calling Sequence: 

JST DELAY: 

DATA # OF TICKS ON THE CLOCK FOR DELAY 

DATA COORDINATION NUMBER 

Returns with: 

INTERRUPTS — ENABLED 
STATUS-UNCHANGED 
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If deleting or changing an outstanding delay: 

A REGISTER-UNCHANGED 

X REGISTER - UNCHANGED 

If actually executing a delay: 

A REGISTER - COORDINATION NUMBER 

X REGISTER - UNDEFINED 

This subroutine is called for one of three reasons: 

1. To delay the current task for a specified period of time. (The number of ticks 
referred to above is the number of time interrupts from the Real-Time Clock. 

These interrupts normally occur every 10 msec but may be changed by a jumper 
wire. (See the appropriate ALPHA-16 or ALPHA LSI Computer Reference Manual). 

For this call, supply a currently unused positive coordination number. 

2. To delete an outstanding delay. A call to DELAY: with the 2's complement of the 
coordination number of any current delay will delete the delay request (and the 
task that called it). This is useful for deleting a watchdog routine. 

3. To change an outstanding delay. A call to DELAY: with the coordination number of 
a currently active delay will change the outstanding delay. This is equivalent 
to deleting a task in a delay and immediately starting the same task with a new 
delay. 
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SECTION 3 

INTERRUPT PROCESSING 


Most interrupt service routines can be divided into two sections. First, the recog¬ 
nition that the requesting device usually has an immediate need which will result in 
data being lost if it is not ftiet. Second, a subsequent need to perform some pro¬ 
cessing upon that data. In the case of output, the device may not continue to operate 
at full speed if its request is not answered within a certain interval. After meeting 
this very high-speed requirement, the need for continued rapid servicing diminishes 
considerably, until the next request is made. 

RTX provides two alternative methods for interrupt service. One is the INTQ: service, 
which combines the functions of saving status, queueing or scheduling of support 
tasks, and then dismissing the interrupt since it has been honored. The second is to 
use the INTSV;, INTAC:, and INTRS: services to provide each of those three functions 
separately. Use of these three functions is described below. 

i 

Upon receiving control after an interrupt, the interrupt handler should immediately 
call INTSV:, to preserve the register status. When control returns, the handler may 
utilize the registers as required. Processing, at this point, should be restricted 
to the very high speed "lost data' 1 requirements. The handler may then schedule other 
activities, by calling INTAC:, with the start address and priority as arguments. 
Processing is ended for this phase, by issuing a call to INTRS:, which resumes pro¬ 
cessing. Normally, the newly scheduled activity will have a high priority. Note, 
however, that the programmer may assign this priority, as distinct from those systems 
where the hardware has the device priorities wired in. When the scheduled processing 
activity receives control, it will be considered a normal activity, and may make use 
of all RTX functions. Interrupts will be enabled, so that other devices which require 
service may receive control during their "lost data" intervals, after which the 
system Scheduler will return control to the highest priority processing program. 

The A and X register are passed between the scheduling and the scheduled routines, so 
that word or byte transfer devices can pass the data itself to the processing pro¬ 
grams. After the processing program has finished its task, it may terminate, or it 
may schedule other responding tasks. 

By using INTSV: and INTRS: to save and restore status, the user is relieved of one of 
the most important and error-prone types of coding. With INTAC:, he can schedule 
routines which are normal, interruptable programs, and which can utilize all of RTX's 
capabilities. 

Note that the INTSV:, INTRS:, INTAC:, and INTQ: routines are necessary only for the 
user who is using RTX in conjunction with his own special (non-standard) device and 
has written his own interrupt handler for it. The RTX I/O Executive (IOX), discussed 
in Chapter 2 of this manual, contains the necessary I/O handler routines for the 
standard CAI-supplied I/O devices (card reader, teletype, high speed paper tape punch 
and reader, magnetic tape, disk and floppy disk). These standard handlers within IOX 
make use of the INTQ: routine internally. 
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3-1 SAVE ENVIRONMENT (INTSV:) 

Calling Sequence: 

JST INTSV: INTERRUPTS MUST BE DISABLED 

DATA SUBENT LOCATION OF ENTRY POINT TO INTERRUPT ROUTINE 

Returns With: 

INTERRUPTS-STILL DISABLED 

STATUS-OV RESET, WORD MODE 

A REGISTER-SAVED P REGISTER 

X REGISTER-UNCHANGED 

This subroutine must be called by an interrupt subroutine to save the current 
environment. 


3.2 RESTORE ENVIRONMENT (INTRS:) 

Calling Sequence: 

JST INTRS: 

- DOES NOT RETURN 

This subroutine is called by an interrupt subroutine to exit. If RTX was interrupted, 
control is returned to RTX. Otherwise, task control is moved to the block at the top 
of the scheduler ready chain and the system Scheduler is entered. 


3.3 INITIATE A NEW TASK FROM AN INTERRUPT SUBROUTINE (INTAC:) 
Calling Sequence: 

JST INTAC: (MUST BE IN WORD MODE) 

DATA (*) START ADDRESS 

DATA PRIORITY 

Returns With: 

INTERRUPTS-UNCHANGED 

OV-INDETERMINATE 

A REGISTER-DESTROYED 

X REGISTER-DESTROYED 
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3.4 INTERRUPT SERVICE AND QUEUE TASK (INTQ:) 

This service may be used in place of the INTSV:, INTRS:, INTAC:, sequence. It is 
functionally identical to the combination of those three services when they are used 
as follows: 


SUBENT 


ENT 

JST 

DATA 

JST 


INTSV: 
SUBENT 
INTAC: 


SAVE ENVIRONMENT 


QUEUE "TASKC" AT "PRIOR" 


TASKC, PRIOR 


INTRS: 


DISMISS INTERRUPT AND GO TO RTX 
SCHEDULER 


The advantage to using INTQ: is that it is faster; i.e., it shortens the period of 
time during which interrupts are disabled. 

Calling Sequence: 


JST 

DATA 


INTQ: 

$ , 0 , 0 , 0 


CALLING LOCATION, 3 TEMPS REQUIRED 


DATA TASK-ADDRESS 

DATA PRIORITY 

DATA A-REGISTER 

DATA X-REGISTER 

DATA P-LOC 


FOR TASK WHICH IS QUEUED 
FOR QUEUED TASK 

VALUE PASSED TO QUEUED TASK IN A 
VALUE PASSED TO QUEUED TASK IN X 
LOCATION OF SAVED P-REGISTER AT 
TIME OF INTERRUPT 


Returns With: 


DOES NOT RETURN. QUEUES TASK FOR SCHEDULER AND DISMISSES 
INTERRUPT. 

Sample Usage 

1. Interrupt for End-of-Block 

EOBENT ENT 

JST 
DATA 
DATA 


VECTORED INTERRUPT 

INTQ: 

$, 0 , 0/0 

TASKB,PRIORB,0,0,EOBENT 
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2. Interrupt for Data (Input) Ready 

DATENT ENT 

SIN 3 

STA AREG 

INA ADDR/FCN 

EMA AREG 

JST INTQ: 

DATA $, 0 , 0,0 

DATA TASKA, PRIORA 

AREG DATA 0 

XREG DATA 0 

DATA DATENT 


3.5 COMMON SUBROUTINES (KEENTRANCE) 

Normally, different activities are independent of each other. However, it is not 
unusual to have two unrelated programs use the same utility subroutines, therefore 
defining a "common" subroutine. One example would be mathematical functions library 
routines. Rather than duplicating copies in each using program, a single copy is 
loaded, and entered with subroutine calls (JST instructions). If control is within 
the common subroutine when an interrupt occurs, and another program gains control and 
re-calls the subroutine, the second call will destroy the return location of the 
first. When control finally returns to the middle of the interrupted subroutine 
(clearing the interrupt), it will complete its execution, and again return to the 
second caller. The original caller never sees control come back. The later caller 
gets two returns from one call. This dilemma is referred to as the common subroutine 
problem, and it occurs in any system which allows interrupt processing. It is solved 
in different ways. Most simply, common subroutines can be forbidden. Alternatively, 
push-down stacks are utilized, scratch storage is forbidden, (except in the stack), 
and the programming task is made significantly more imposing. 

RTX has implemented an alternative solution to this problem, that of a "shared" 
facility. In our context a shared facility is a body of code which may be called 
concurrently from more than one task. In this sense, a shared facility is then 
common to several tasks. 

This implementation consists of two services which are contained in RTX. These are: 

SUBR: To initiate the execution of a shared facility 

SUBX: To return from a shared facility 

To illustrate usage of these services, consider the following example. If the 
subroutine CUP is a common subroutine to two tasks (named COFFEE and TEA) , then it is 
possible that an interrupt could occur which causes task COFFEE to execute before 
task TEA Finished. This means that subroutine CUP could be entered from COFFEE 
before it completed the processing due to its prior entry from TEA. In this case, 
subroutine CUP is in common usage . It is designated as a shared facility and must be 


VECTORED INTERRUPT 
BLOCK BYTE MODE 
SAVE A-REG 

INPUT THE DATA VALUE 

RESTORE PROPER A-REG AND PASS INPUT 

VALUE TO QUEUED TASK 


A-REG VALUE FOR TASK 
X-REG VALUE FOR TASK 
RETURN POINTER FROM INTERRUPT 
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designed to accomodate that condition. The method here is to use the following 
sequence of code in both COFFEE and TEA whenever it is desired to call subroutine 
CUP s 

JST SUBR: 

DATA CUP 

instead of the usual method 

JST CUP 



NEVER call a common subroutine directly? that is, with a JST name. 
ALWAYS call a common subroutine using 

JST SUBR: CALL THE SUBR: SERVICE 

DATA NAME NAME OF COMMON SUBROUTINE 

(or using the LOCK: or PROT: routines described below). 


3.6 WRITING COMMON SUBROUTINES 

The rules for writing a common subroutine are very simple. They apply to the sub¬ 
routine exit instruction. There are two rules: 

1. Instead of the traditional RTN instruction, use a JMP to the location directly 
before the subroutine entry point. 

2. In the location directly before the subroutine entry point, place a JST SUBX:. 

Use of these two rules will allow an orderly exit from the common subroutine. In our 
previous example, subroutine CUP looks like this: 

NAM CUP 

EXTR SUBX: 

JST SUBX: 

CUP ENT ENTRY TO COMMON ROUTINE CUP 

JMP CUP-1 EXIT COMMON ROUTINE 

When SUBR: and SUBX: are used, all subsequent calls to the common subroutine are 
"locked out" until the current call to the subroutine has completed and the jump to 
SUBX: has been made. Then, each subsequent call (made while the common subroutine was 
busy) is completed in priority order. A 

If this procedure is not followed, the system behavior will appear to be very erratic 
Although the system will probably correct itself, when the doubly-returned task 
finally terminates, one activity has been lost, and one has been duplicated, probably 
incorrectly. If the user understands this section thoroughly, he can have the con¬ 
venience of library subroutines, without the difficulty of accidental re-entry. 


ACTUALLY CALL SUBR: SERVICE 
NAME OF COMMON SUBROUTINE 
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3.7 CALL A COMMON SUBROUTINE (SUBR:) 

This subroutine is called by a user task to schedule a subroutine which may 
be used by more than one task- 


NOTE 


This subroutine does not return directly to the calling program. It 
exits through the Scheduler (SCHED:). 

Calling Sequence: 

JST SUBR: 

DATA (*) ADDRESS OP COMMON SUBROUTINE 

Enters Subroutine With: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A REGISTER-UNCHANGED 

X REGISTER-UNCHANGED 


NOTE 


The return address put in the entry point of the common subroutine is 
the location following the data in the above call. That is, it 
appears to the subroutine as if it were called from the location of 
its address (Not the location of the "JST SUBR:"). 





3.8 EXIT FROM COMMON SUBROUTINE (SUBX:) 

This subroutine is called from within a common subroutine to return to the calling 
task. 

woTi I 

This subroutine does not return directly to the calling program. It 
exits through the Scheduler (SCHED:). 

Calling Sequence 

JST 

SUB ENT 

JMP 


SUBX: 

where: 

SUB-1 


SUB is the entry point of the common 
subroutine. This call must immediately 
precede the entry so that RTX can keep 
its chains straight. 

RETURN 
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Returns to calling task with: 

INTERRUPTS--ENABLED 

STATUS-UNCHANGED 

A REGISTER—-UNCHANGED 
X REGISTER-UNCHANGED 



Each SUBR: call made must have a corresponding call made to SUBX: once 
the routine has completed. If a call to END: (to terminate the calling 
task) is made from within a s$$^out:ine called by SUBR:, all other tasks 
will be permanently denied the user of that routine. To terminate a task 
from within a SUBR'd subroutine, the ABORT: routine should be used. 


3.9 PROTECT A FACILITY (PROT:) 

PROT: is called by a user's subroutine to protect itself from usage by other tasks. 

It is in a way similar to SUBR: in that reentrance to a common subroutine is prevented 
during its usage; however, in SUBR:, the determination to protect the subroutine is 
made by the calling program , while in PROT:, the determination is made by the sub¬ 
routine itself. 

Calling sequence: 

DATA 0 

SUB ENT 

JST PROT: 

DATA $-3 

The call to PROT: must be the first instruction following the entry point. The temp 
cell SUB-1 is used by PROT: to store the contents of SUB (the return address from the 
caller) . Note that exiting from the routine SUB must be done via the return address 
in SUB-1, not the address in SUB. 

Returns with: 

Interrupts—enabled 

STATUS—-UNCHANGED 

A-REGISTER-UNCHANGED 

X-REGISTER-UNCHANGED 

PROT: may be called more than once using the same coordination number by the same 
task. However, a different task is effectively locked out of the subroutine until it 
is released by executing a call to UNPR:. 
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NOTE 


The INTRS: and INTQ: subroutines contain logic to preclude task¬ 
switching caused by an interrupt occuring immediately before a JST 
LOCK; or JST PROT: instruction. This involves checking the inter¬ 
rupted instruction to see if it is a JST LOCK: or JST PROT: . This 
check is effective only if the instruction is a JST indirect through 
a base page pointer to LOCK: or PROT:; that is, an :F9xx instruction. 
To insure this protection feature, reference LOCK: or PROT: by means 
of an EXTR directive, rather than a KEF directive. This also implies 
that if EXTR directives are used in conjunction with the LPOOL 
directive, then an EXTR LOCK: or EXTR PROT: must be accompanied by a 
SPAD LOCK: or SPAD PROT: directive to insure that the pointer remains 
in the base page. 


3.10 RELEASE A PROTECTED FACILITY (UNPR:) 

UNPR: is called by a common subroutine to delete its protected condition caused by a 
previous call to PROT: 

Calling Sequence: 

JST UNPR: 

DATA Coordination Number 

Returns with: 

INTERRUPTS-ENABLED 

STATUS——UNCHANGED 
A-REGISTER—UNCHANGED 
X-REGISTER-UNCHANGED 


In effect, RTX treats the address'of a common subroutine (as used, in SUBRs and SUBX;) 
as a coordination number. These are shared with the coordination numbers used by 
PROT? and UNPR:. That is, the list in which the common subroutine addresses are 
saved for SUBRi is the same list that saves the coordination numbers for PROT: and 
LOCK:, Results will be unpredictable (and probably disastrous) if the coordination 
number used by PROT:, UNPR:, LOCK: or UNLK: is also the address of a common subroutine 
(called by subr*). 

Because RTX maintains a single list for PROT: and LOCK: coordination numbers and 
SU1R: common subroutine addresses, an alternative method for writing common sub” 
routines exists. The rules for this type of common subroutine are: 

1* Instead of the standard "RTN sub" instruction, use a " JMP SUB-2". 

2, in the 2 locations directly before the subroutine entry point, place: 

JST SUBX: 

RES l 
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3. In the two locations immediately following the subroutine entry point, place: 

JST PROT: 

DATA SUB-1 


4. 


Because PROT: moves the return address from SUB to SUB-1, references to parameters 
must be made through SUB-1, rather than SUB. For example, a typical routine, 
that adds the arguments presented to it and returns the sum in the A register, 
would normally be coded as follows: 


Calling Sequence: 



JST 

ADDM 


DATA 

3 


DATA 

4 

ADDM 

ENT 



LDA 

*ADDM 


IMS 

ADDM 


ADD 

*ADDM 


IMS 

ADDM 


RTN 

ADDM 


NOTE 


This may not be used as a common subroutine because it has no 
protection from re-entrance. 


Using the SUBR: common subroutine feature, the routine would appear as follows: 
Calling Sequence: 


ADDM 


JST 

SUBR: 

DATA 

ADDM 

DATA 

3 

DATA 

4 

JST 

SUBX: 

ENT 


LDA 

*ADDM 

IMS 

ADDM 

ADD 

*ADDM 

IMS 

ADDM 

JMP 

ADDM-1 
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The alternative method, using the PROT: common subroutine feature, is as follows: 
Calling Sequence: 


JST ADDM 

DATA 3 

DATA 4 

JST SUBX: 

RES 4 1 

ADDM ENT 

JST PROT: 

DATA ADDM-1 

LDA ' *ADDM-1 

IMS ADDM-1 

ADD *ADDM-1 

IMS ADDM-1 

JMP ADDM-2 

The advantages of the last example, using the PROT:/SUBX: sequence, are: 

1. The calling sequence is shorter than that calling SUBR: (“the standard JHT SUB is 
used). 

2.. The burden for insuring that the subroutine is common (re-entrance protected) 
lies solely with the subroutine writer, not the subroutine caller. 

3. If the subroutine is capable of stacking multiple return addresses (not shown in 
this example), the subroutine is then recursive, and may call itself. (Note that 
if recursive, SUBX: should only be called on the last return (use RTN SUB-1 for 
all returns but the last)). 


3.11 LOCK OUT A FACILITY (LOCK:) 

LOCK: was designed for use by Real Time FORTRAN, and is similar to PROT:. The only 
difference between them is that the return address from the subroutine is stored in 
the location following the coordination number, instead of the location in front of 
the entry point, e.g.: 

Calling Sequence: 


JST LOCK: 

DATA Coordination Number 

DATA 0 (Return address stored here) 

Returns With: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A-REGISTER-UNCHANGED 

X-REGISTER-UNCHANGED 

The JST to LOCK: must be the first instruction following the subroutine entry point, 
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The user should reference the LOCK: or PROT: subroutine with an EXTR directive, 
rather than a REF directive. See the note in the PROT: description regarding this. 

Note that the PROT:/SUBX: example shown above does not apply to LOCK:. 


3.12 UNLOCK A LOCKED FACILITY (UNLK:) 

UNLK: is an alternate name for UNPR:, and is provided solely for symmetry in 
documentation. 


3.13 ABORT A TASK (ABORT:) 

ABORT: is called from within a common subroutine to terminate the task which called 
the subroutine. 

In addition to performing the END: function, ABORT: also deletes any PROT:, LOCK: or 
SUBR: conditions previously set by the aborted task. 

Calling Sequence: 

JST ABORT: 

ABORT: exits to the scheduler (SCHED:). 

I NOTE I 


The duration of an ABORT: call is significantly longer than an END: 
call, and therefore it should be called only if in a common subroutine, 
or in a PROTected or LOCKed condition. 


3.14 OBTAIN CURRENT PRIORITY (GETPR:) 

Calling Sequence: 

JST GETPR: 

Returns With: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A REGISTER CONTAINS TASK PRIORITY 
X REGISTER-UNCHANGED 

The subroutine is called to get the current priority of a task. It is usually 
called so that a task*s priority may be restored after it is temporarily altered. 
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3.15 SET TASK PRIORITY (SETPR:) 

Calling Sequence: 

LDA DESIRED PRIORITY 

JST SETPR: 

Returns With: 

INTERRUPTS—ENABLED 

STATUS- OV RESET, WORD MODE 

A REGISTER- UNCHANGED 

X REGISTER-UNCHANGED 

This subroutine is called whenever a task desires to alter its priority. 


3.16 INCREMENT TASK PRIORITY (INCPR:) 

Calling Sequence: 

JST INCPR: 

Returns With: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A REGISTER-UNCHANGED 

X REGISTER-UNCHANGED 

This subroutine will increment the priority of the calling task by 1. No range 
checking is performed. 


3.17 DECREMENT TASK PRIORITY (DECPR:) 

Calling Sequence: 

JST DECPR: 

Returns With: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A REGISTER-UNCHANGED 

X REGISTER—UNCHANGED 

This subroutine will decrement the calling task's priority by 1. No range checking 
is performed. 
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SECTION 4 

ADDITIONAL RTX FEATURES 


4.1 RTX DEBUG FEATURE (ZBG) 

The standard CAI DEBUG program is included in the RTX library tape (Segment 1) under 
the name ZBG. (Detailed descriptions of DEBUG are included in LSI-2 AutoMagic, CA 
document 96045-00, or LSI-3/05 AutoMagic, CA document 93001-00). When this module is 
linked. Relocation Register RF points to the RTX Linked list pointers for use with Z 
function; the corresponding length required by the Z function is set to five words, 
which is the length of each block used in the RTX Linked lists. When displaying a 
particular list with the Z function, the first printed line is not an entry in the 
list, but simply the pointer to the top of the list, followed by the next four higher 
words in memory; this first line may therefore be ignored. 

There are eight lists maintained by RTX, and the pointers to the top of each of these 
lists reside within the RTX nucleus in eight consecutive memory locations, in the 
! following order: 

0RF Pointer to the list of tasks awaiting execution (READY) 

1RF Pointer to the list of INTQ: and INTAC: tasks awaiting execution (FIFO) 

2RF Pointer to the,list of tasks currently awaiting completion of a DELAY 

(DLYCH) 

3RF Pointer to the list of common subroutines currently requested (COMN) 

4RF Pointer to the list of tasks currently awaiting I/O execution (IOCH) 

5RF Pointer to the list of tasks awaiting a PUT: response to a requested 

GET: (GETCH) 

6RF Pointer to the list of PUT: requests awaiting a GET: response (PUTCH) 

7RF Pointer to the list of currently unused blocks (FREE) 

The following is a description of the contents and manipulation of a user block 
within each of the lists: 

1. READY List (RF) Ready to Run (used by BEGIN:) 

RTX maintains a list of all tasks which are ready to execute in the READY list. 
This list is sorted into priority order, so that RTX simply executes the task 
at the top of the list. The format for a READY block is as follows: 

Con tents 

0 Word address pointer to next block entry in the list. (The last 

element in the list contains a zero). 

1 Bits 15-3. Task priority number. 

Bits 2-0. (LSI-2 only) 

Bit 2. EIN indicator, for reference only. (RTX always 

allows interrupts.) 

Bit 1. BYTE mode indicator upon next resumption of task. 

Bit 0. Overflow indicator upon next resumption of task. 
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Word Co ntents 

Bits 2-0. (LSI-3/05 only) 

Bit 2. BYTE mode indicator upon next resumption of tcisk. 

Bit 1. Overflow indicator upon next resumption of task. 

Bit 0. Unused 

2 P register contents upon next resumption of task. 

3 A register contents upon next resumption of task. 

4 X register contents upon next resumption of task. 

FIFO list (1RF) Ready to Run (used by INTAC: and INTQ:) 

In order to avoid the problems of interrupting a linked list processor, INTQ? 
and INTAC: put the entries for their tasks in the FIFO list. (BEGIN: operates 
directly on the READY list). The RTX scheduler (which is never run as an 
interrupt routine) empties the FIFO list into the READY list and sorts the 
READY list. The format of a FIFO block is the same as a READY block. 

DLYCH List (2RF) Delay (used by DELAY:) 

A call to DELAY: (with a unique positive coordination number) causes the block 
for the currently executing task to be deleted from the READY list and put on top 
of the DLYCH list* The format of a DLYCH block is as follows: 

Word Contents 

0 Word address pointer to next block in the list. 

1 Status & Priority. Same as READY list entry. 

2 The P register. Points to address of return from DELAA?: 

3 The coordination number. 

4 Working number of ticks left in Delay. 

Upon return, the A register will contain the coordination number. The X register 
will contain the number of Real Time Clock "ticks” remaining (normally zero). 

COMN List (3 RF) Common Subroutine (used by SUBR: , SUBX: , LOCK:, IJNLK : , PROT: , 
UMPRs) 

A call to SUBR ; LOCK: or PROT: causes the COMN list to be searched for a block 
for this common sub'ccut Ine. If none is found, a block is deleted from the FREE 
list and put on top of the COMN List. The format for a COMN block is as followss 

Word Contentu 

0 Pointer to the next block in the list 

1 Busy f’Lao (zero - not busy) 

2 Pointer to the block of the highest priority task waiting to use 
the common subroutine (0 - no task waiting) 

3 Address of the common subtoutine (or coordination number) 

4 Unused 

If SUBR: is called <n:d a block for the common subroutine is found with the Busy 
flag set, the block for the currently executing task is deleted from the READY 
list, and inserted into a secondary list pointed to by Word 2 above. At the same 
time, the P register is set so that the task will again cal.1 SUBR: when RTX next 
executes the task. 
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5. IOCH List (4RF) I/O Suspend (used by IOX:, Fortran Interface) 

A call to 10: or IOWAT: when the busy flag is set in the IOB, or a Fortran call 
for I/O when no parameter block is currently available, will cause the task block 
to be deleted from the READY list and put on the top of the IOCH list. The P 
register is set so the task will repeat the call when RTX next executes the task. 
The format of an IOCH block is the same as for a READY block. The IOCH list is 
emptied into the READY list each time any I/O completes. 

6. GETCH List (5RF) Get (used by GET:) 

A call to GET: with a unique positive coordination number (and no matching PUT: 
yet) causes the block for the currently executing task to be deleted from the 
READY list and put on top of the GETCH list. 

Word Contents 

0 Pointer to next block in the list 

1 Status & Priority (same as Ready) 

2 P register. Points to return from GET: 

3 Coordination No. 

4 Unused 

When the associated PUT: is done, the block is deleted from the GETCH list, the 
A and X register contents are stored into words 3 and 4 r and the block is inserted 
into the READY list in priority order. 

7. PUTCH List (6RF) Put (used by PUT:) 

A call to PUT with a unique positive coordination number (and no waiting GET:) 
causes a block to be deleted from the FREE list (see below) and added to the top 
of the PUTCH list. The format for a PUTCH block is as follows: 

Word Contents 

0 Pointer to next block in the list 

1 Unused 

2 A register contents to be passed 

3 Coordination No. 

4 X register contents to be passed 

When the associated GET is processed, the block is deleted from the PUTCH list 
and put on top of the FREE list. 

8. FREE List (7RF) Available Storage 

This list is initialized to contain the entire work space during a call to RTX:. 

As blocks are required, they are taken from the top of the FREE list. As blocks 
are no longer required, they are deleted from the appropriate list and put onto 
the tail of the FREE list. A FREE block has no specific format. It will simply 
contain data from the function which last used the block. 


1/4-3 


ComputttnlUitomaitkm 


4.2 PROGRAM LOADING WITH ZBG 


ZBG resides in the RTX library; to make use of ZBG, it is necessary to include a 
ZBG REF 

instruction within the user's program. Thus ZBG is entered immediately upon execu¬ 
tion/ and may then be used to breakpoint through the mainline sequence and any parti¬ 
cular task. 


4.3 POWER-FAIL, AUTO-RESTART (PWKFL:) 

If the computer being used has the Power Fail option, the user may utilize the RTX 
, program module which provides service for that device. The loader will cause the 
routine to be loaded if the user has a KEF to PWRFL: . He must, however, not actually 
call that program at execution time. Instead, if a power failure begins, the inter¬ 
rupt hardware will force control into that routine, saving the computer's register 
states, and halt, to prevent loss of information from core storage. When the power 
is restored, the program will schedule a user-supplied routine, which must be named 
PWRUP:, and must occur in a NAM directive. Re-initiation of the activity which was 
in process (at the time of the power failure) will also be scheduled and control 
will be passed to the system Scheduler. 

■ RTX will schedule PWRUP: as a task at priority 8184 with the contents of the A 

register nonzero if the power failure was detected. If power failure was not detected 
(e.g., the computer was halted), RTX will transfer control to PWRUP: with the 
contents of the A register equal to zero. Note that RTX cannot resume the activity 
in progress at the time of the power failure if the power failure was not detected. 

4.4 TELETYPE INPUT/OUTPUT 

RTX provides decimal, octal, and hexadecimal I/O on the standard Teletype, by using a 
software interface to CAl's Teletype utility Package (TUP). The calls and usage are 
identical to the standard version. 

TUP also provides the capability to read and print strings of text, (for headings, 
labels, etc.), and this capability is retained in the RTX version. 

Refer to the standard TUP documentation (#96014) for a complete description of each 
routine. Additionally, a specific limitation exists with respect to TUP usage through 
RTXt . TUP must not be called concurrently by more than one task, because TUP itself 
calls subroutines within it with 1ST instructions, and these subroutines are not 
protected from re-entrance. 

TOP resides on the RTX Segment 2 library tape, and its routines should be referenced 
with the REF or EXTR directive. 


4.5 LSI-3/05 SOFTWARE CONSOLE ROUTINE (CNSOL3) 

The LSI-3/05 version of RTX includes CNS0L3, the Software Console Routine, which may 
be linked by a reference to CNS0L3 in the user program module. Usage of the Software 
Console Routine is described in the LSI-3/05 Software Manual (90-20010-00). 
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SECTION 5 

RTX OPERATING PROCEDURES 


1. Asseinble each of your application program modules. Be sure to reference each RTX 
function that a module uses in either an EXTR or a REF directive. 

2. When you have a useful object tape for each of your modules, you are ready to 
create the executable application program. This requires that you first load 
LAMBDA, the relocating, linking loader. 

3. Using LAMBDA, force load the initializer task module of your application. 

4. Then using LAMBDA, load the remainder of your group of application program 
modules. You can use the Selective Load feature of LAMBDA to include only the 
modules your program actually requires. 

5. Still using LAMBDA, selectively load the RTX Library object modules from the three 
RTX Library Tapes. The first tape applies only to COMX and is not needed unless 
COMX is to be used. The tapes are: 



Segment 0 - COMX 
Segment 1 - RTX/IOX 
Segment 2 - RTX/IOX 


LSI-2 

70-93300-32 

70-93300-30 

70-93300-31 


LSI-3/05 

70-93301-32 

70-93301-30 

70-93301-31 


NOTE 


If the user program does not reference PROT: and LOCK:, LAMBDA and 
OS:LNK will declare these subroutines as undefined. This declaration 
can be ignored since INTRS: and INTQ: (loaded after PROT: and IX)CK:) 
check to see if a call to either subroutine is the next instruction 
after an interrupt is serviced. 

| NOTE 


When operating under the IOX File Manager, disk devices must be 
labeled prior to their use. Labeling is done with the stand¬ 
alone program, RTX File Label Utility (tape Nos. 70-93324-40A1 
and -41A1). Subsection II/5.3 gives a complete description of 
this utility. 


6. Start execution of your program so that the initializer module (Mainline Sequence) 
or ZBG, if used, is executed first. 
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Section 6 

A SAMPLE RTX PROGRAM - RTX DEMO 


6.1 PROGRAM DESCRIPTION 

The RTX Demo Program (00-93300-33) demonstrates the basic functions of RTX in a 
simple, straightforward manner. It consists of three main tasks (TASK1, TASK2, 

TASK3) . The function of each of these tasks is to delay a specific amount of time, 
and then call a routine to output a message to the teletype. The message consists of 
the task name followed by the elapsed time in seconds since the start of the program. 

An actual user's application of RTX might very well use the interrupt from some 
external device to initiate a task. This example simulates the effect of three such 
devices which interrupt every 5, 7, and 11 seconds, respectively; that is, the delays 
themselves simulate external devices. 

Each task delays a different amount of time than the other tasks, before printing. 

TASKl delay: 5 seconds 

TASK2 delay. 4 7 seconds 
TASK3 delay: 11 seconds 


Thus TASKl 

will output 

"TASKl 

0005” 

"TASKl 

0010” 

"TASKl 

0015” 

etc. 


TASK2 will 

output 

"TASK2 

0007” 

"TASK2 

0014” 

"TASK2 

0021" 

etc. 



And TASK3 will output 

"TASK3 0011" 

"TASK3 0022” 

"TASK3 0033” 

etc. 

Because of teletype timing, each message takes more than one second to complete. 
Thus the three tasks will contend with each other for the use of the teletype. 
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In addition, a fourth task called "IOTASK" outputs the actual teletype messages. This 
task is begun by each of the three main tasks whenever their delays expire, at the 
following various priorities: 

TASKl begins IOTASK at priority 5 
TASK2 begins IOTASK at priority 7 
TASK3 begins IOTASK at priority 11 

This means that if TASKl and TASK3 both begin IOTASK at the same time (which they 
will, at 55 seconds), TASK3's message will be output first, since its priority to 
begin IOTASK is higher than TASKl's. 

To be more specific, and to demonstrate the priority sequence more fully, the actual 
teletype output after 55 seconds appears as: 


TASK3 0055, TASK2 0056, TASKl 0055,...because each message takes slightly more than 
one second to print, thus causing the following sequence: 


TIME 

55 seconds after start 


56 seconds after start 


57+ seconds after start 


ACTION 

TASKl and TASK3 both begin IOTASK with a "55 seconds" 
message. Since TASK3 has the higher priority, its 
message is printed first. 

TASK2 begins IOTASK with a "56 seconds" message. 
TASK3's "55 seconds" message is still printing, and 
TASKl's "55 seconds message" is queued up. Since 
TASK2 has a higher priority than TASKl, the TASK2 "56 
seconds" message gets output when TASK3's message 
completes. 

TASKl's "55 seconds" message is output after TASK2's 
"56 seconds" message is completed. 


After 80 seconds, the teletype listing should appear as: 


TASKl 0005 
TASKS 0014 
TASKl 0025 
TASK2 0035 
TASKl 0045 
TASK2 0056 
TASK2 0070 
TASKS 0077 


TASK2 0007 
TASKl 0015 
TASK2 0028 
TASKl 0035 
TASK2 0049 
TASKl 0055 
TASKl 0070 
TASKl 0080 


TASKl 0010 
TASKl 0020 
TASKl 0030 
TASKl 0040 
TASKl 0050 
TASKl 0060 
TASKl 0075 


TASK3 0011 
TASK2 0021 
TASK3 0033 
TASK2 0042 
TASK3 0055 
TASK2 0063 
TASK3 0077 


TASK3 0022 
TASK3 0044 
TASKl, 0065 


TASK3 0066 


(TASKS's message contains carriage return and line feed control characters). 


6.2 PROGRAM MODULE FUNCTIONS 

Let us now examine the RTX functions used in this program (refer to the flowchart in 
figure 6-1 and the program listing at the end of this section). There are six basic 
modules comprising the program: 


BEGIN 

TASKl 

TASKS 


TASK3 

IOTASK 

ADD1 
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6.2.1 BEGIN (Initialize and Begin Tasks) 

The program start occurs at the BEGIN section of the flowchart. The first step is to 
initialize RTX. This is performed using the RTX: function to define the maximum 
number of RTX tasks which may be in concurrent operation and the required table space 
for RTX management of those tasks. If insufficient table space is found or other 
peculiarities occur during initialization> the error return is taken. In our example, 
we halt the computer to remedy the problem. Using the BEGIN: function of RTX defines 
the task name (TASK1, TASK2 and TASK3 in our example) and its software priority 
number (100 for each in our example). 

No other tasks have begun their activity at this point. This is because the first 
task following the RTX: call (the initialization sequence itself) is automatically 
scheduled at the highest software priority. When the END: function is called, this 
task is deleted and the Scheduler can then schedule the other tasks in relation to 
their priority. 

Since the three tasks all have priority 100 and priority 100 is the highest active 
priority value, the Scheduler will arrange each task in sequence according to the 
order in which it was initiated by the BEGIN: call, and will then start execution of 
the first task in that sequence. The sequence is determined by a first-in, first-out 
rule. Therefore, TASK1 executes until it requests an RTX service which causes it to 
be suspended. 

When the task is re-scheduled (on completion of one of the above function calls) , it 
is put back in sequence at the end of all other equal priority tasks. 

This type of organization allows for true priority scheduling within an application, 
while also allowing the tasks themselves to be executed, interrupted, and resumed in 
an orderly fashion. 


6.2.2 TASKl (Delay 5 seconds, Then Output Name and Elapsed Time) 

When TASKl is begun, it first performs a five second delay. This is done by a call 
to DELAY: with parameters of 500 (number of 10 millisecond real time clock "ticks" to 
delay) and 1 (a specific coordination number for this particular task's delay calls). 
The coordination number is necessary mainly for identifying a delay to be changed or 
deleted; however, it is also required when beginning a new delay, as in this example. 
When the delay is completed, control is returned to TASKl, which then calls the 
subroutine ADD1, which increments the elapsed time in the TASKl message by five 
seconds. Note that ADD1 is called via SUBR: , because it is a common subroutine used 
by all three tasks, and is not re-entrant; thus SUBR: prevents another task from 
entering ADD1 until this call is completed. 

Upon return from ADD1, the message is ready for output to the teletype. This is done 
by a call to BEGIN: to initialize the common task called "IOTASK," which in turn 
makes the actual call to the I/O executive (IOX) to perform the output. Note that 
"IOTASK" is a task, not a subroutine; this means that TASKl may now continue with its 
next 5-second delay while the I/O is in progress rather than upon its completion, 
which would invalidate th£ elapsed time count. Also, the initiation of the common 
task is made with a priority of 5. IOTASK is also initiated by TASK2 and TASK3, with 
priorities of 7 and 11 respectively, so that a predictable ordering of outputs is 
achieved when two or three tasks are vying for the teletype at the same time. 
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6.2.3 TASK2 (Delay 7 Seconds, Then Output Name and Elapsed Time) 

TASK2 is identical to TASKl in its logical functioning. The only difference between 
them is in the parameters passed in their calls to DELAY:, ADDl, and IOTASK. TASK2 
calls DELAY: with a 7 second count and a coordination number of 2 (to differentiate 
it from TASKl's delay call). The common subroutine ADDl is called to increment the 
elapsed time by seven instead of five, and the common task IOTASK is begun at a 
higher priority (7). 


6.2.4 TASK3 (Delay 11 Seconds, Then Output Name and Elapsed Time) 

TASK3 is similar to TASKl and TASK2. TASK3 calls DELAY: with an 11 second count and 
a coordination number of 3. It calls ADDl to increment the count by eleven, and 
begins IOTASK at priority 11. 


6.2.5 IOTASK (Call IOX To Output A Message On The Teletype) 

IOTASK is a common task begun as a task by BEGIN: calls in TASKl, TASK2 and TASK3. 
Upon entry, the X register contains an address pointer to the I/O Information Block 
(IOB) of the calling task. A call is then made to the IOX package (at its entry 
point named 10:) passing the IOB address as a parameter. An error status from the 
I/O operation will cause the computer to halt. Otherwise, the task terminates itself 
with a call to END:. 


6.2.6 ADDl (Common Subroutine To Increment The Elapsed Time for Printing) 

ADDl is a common subroutine called by TASKl, TASK2 and TASK3 prior to printing their 
messages. Upon entry, the A register contains the amount by which to increment the 
elapsed time tally, which is pointed to by an address in the X register. The routine 
performs the addition, and then returns to the calling task through SUBX:. This is 
because the subroutine was called via SUBR: to avoid re-entrance. 
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Figure 6-1. RTX Demo Program - Flow Diagram (Cont d) 
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THE INPUT/OUTPUT EXECUTIVE (IOX) 
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SECTION 1 

IOX GENERAL DESCRIPTION 


IOX is a subsystem of RTX which operates under RTX control, and provides the user with 
a complete, modular method of input/output device management and support. Application 
programming is faster since time-consuming input/output programming for standard 
peripherals and communications devices need no longer be done by the user. Since IOX 
is open-ended, the user can add capability for virtually any kind of device unique to 
his application and program it under IOX control. All I/O performed by IOX is 
interrupt-driven and allows other tasks in the system to execute even though I/O is in 
progress. 

Working in conjunction with IOX is the File Manager that enables the user to communi¬ 
cate with data files by name, independent of the physical medium storing the file. 
Requests for file access are made through IOX using Logical Units (LUNs). 

IOX can perform one operation at a time for each peripheral device. Operations 
requiring the use of the same device are done in I/O task priority order (i.e., the 
highest priority request is honored whenever the device is available to be used). 
Operations performed on different devices are done concurrently. All calls to IOX 
specify a Logical Unit (LUN) on which to perform the I/O rather than physical units. 
This feature allows a program to be debugged using one set of I/O assignments and 
executed using another. 

IOX satisfies the following I/O requirements of the system: 

1. Selects the proper commands for communicating with external devices. 

2. Processes device interrupts in the following manner: 

a. Saves the status of the currently executing task. 

b. Determines the task priority of the interrupt. (Must it be serviced immedi- * 
ately or can it wait for the completion of a higher priority task and if so, 
is the higher priority task ready for execution?) 

c. Determines whether the task processing the interrupt is a re-entrant task, or 
that the interrupt may not be serviced until each prior interrupt has been 
fully processed. 

d. Determines which of the I/O tasks awaiting execution has the highest 
priority, then restores the CPU status to the environment of that highest 
priority and gives control to that task. 

e. Ensures that no task may access a device while it is controlled (dedicated) 
by another task. 

f. Ensures that the interrupt system is not disabled for a period of time which 
would prevent a high speed device from performing I/O successfully. 
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1.1 GENERAL DESCRIPTION 

Because of the likelihood of having several similar devices attached to the computer 
(including identical units) in a real time environment, IOX has been designed to make 
it easy to support several similar devices (differing only by device address) using 
"shareable 11 code. IOX requires some space for flags, device addresses, etc. Since 
the types of flags depend on the device, as well as the interface to which the device 
is connected (there may be more than one device per controller), IOX maintains flags 
in two separate locations depending on whether the information is unique to the 
device or to the controller. In order to utilize the minimum space in memory for 
these flags and temporary cells, and to facilitate the allocation of these cells, IOX 
does most of its interfacing by means of tables which define the type of device and 
interface to which it is connected. 

IOX is primarily concerned with four tables: 

IOB Input Output Block 

UAT Unit Assignment Table 

DIB Device Information Block 

CIB Controller Information Block 

(These tables are more fully described in section 2 (IOB and UAT) and section 4 (DIB 
and CIB). The IOB is created by the user (task) and resides within the calling task. 
It contains the Logical Unit Name or Number (LUN) as well as specifications for the 
I/O operation to be performed. 

The UAT is also created by the user. It is a series of two-word entries, each of 
which equates the LUN (specified in the IOB) to a specific device. 

Hie DIB and CIB are tables which are used in communication between IOX and a parti¬ 
cular handler. IOX contains within it DIB's and CIB's for each standard device. 
Additionally, the user may create his own tables if he desires; for example, he may 
reserve an extent on a disk by specifying its boundaries in his own disk DIB, or he 
may create a DIB and CIB (and a handler) for a non-standard device. 

In general, the usage of these tables by IOX is as follows: The user constructs the 
IOB within his program and calls IOX, giving as the sole argument the address of this 
IOB. IOX must then transfer control to the handler associated with this request. To 
do so, it first obtains the logical unit number (LUN) from within the IOB, and com¬ 
pares it to each entry in the UAT until a match is found. The UAT is simply a list 
of &ach possible Logical Unit Name/Number (LUN) , associated with the address of the 
DIB which defines the device assigned to that LUN. Thus for each LUN the UAT contains 
a pointer to the appropriate DIB. In turn, each DIB contains a pointer to the CIB 
which defines the interface to which the device is connected. Finally, the CIB 
contains a jump table which points to the particular handlers (procedures) for pro¬ 
cessing the specific request. Therefore, given an IOB and a UAT, IOX can find the 
procedure to handle the request made in the IOB. 

The following steps are performed during a normal call from the user to IOX: 

1. The user calls IOX carrying the word address (may be indirect) of his IOB. 

2. IOX examines the status within the IOB. If the IOB is busy (from a previous call 
to IOX), the calling task is suspended and control is passed to the RTX task 
scheduler. 
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3. If the IOB is not busy, it is then flagged as busy, and the UAT is searched to 
find a LUN which matches the LUN in the IOB. If not found, an abnormal return is 
made to the caller after setting the "Invalid LUN" status bit in the IOB. 

4. If a matching UAT entry is found, the correct DIB is located (the DIB is refer¬ 
enced within the UAT entry) and the requested function code is compared to the 
permissible function code(s) within the DIB. If the requested function code is 
found to be illegal, an abnormal return is made to the caller after setting the 
"Error” status bit in the IOB. 

5. IOX next queues the I/O request with any previously pending I/O requests for the 
requested device according to the priority of the calling task and passes control 
to its internal I/O scheduling routine. 

6. The scheduling routine then monitors the request queue in each DIB? whenever it 
becomes physically possible to begin an I/O request (the I/O device is available 
and no higher priority request is pending), the scheduler calls the appropriate 
I/O handler routine (driver) according to the handler entry address within the 
CIB. 

7. In general, the I/O handler routine will set up the required interrupt locations, 
select the device, and initiate a watchdog timer, and then return control to the 
I/O scheduler. 

8. The I/O scheduler continues monitoring the I/O request queues and calling the 
applicable I/O handler routine(s) until each DIB has been examined once. Then 
the I/O scheduler terminates with a call to END:. 

9. When an end-of-block I/O interrupt occurs, it causes a return to the I/O handler 
which initiated the I/O operation. The handler will normally at this time, call 
an end-of-block routine within IOX, which stores the I/O status and record count 
into the IOB, releases the device from dedication (if desired), returns to the 
calling task through either the normal or the abnormal return location, depending 
on the status, and begins the I/O scheduler. 

10. If an I/O error should cause the watchdog timer to expire prior to I/O completion, 
it causes a return to the applicable handler, which will then normally execute an 
initialize function to the device, store an "Unresponsive Device" status into the 
IOB and return to the caller*s abnormal return location. 


1.2 CALLING SEQUENCES 

The three entry points to IOX are: 

10: To perform an I/O operation or special function 

IOREL: To release a dedicated device 

IOWAT: To wait for completion of an I/O operation 


c 
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Each of these entries requires a parameter list (IOB). IOB format is described in 
detail in section 2. The IOB specifies the type and mode of operation, data area, 
data length, and the Logical Unit Name /Number, It also provides room for status 
information to be returned to the calling task. All calls to IOX return with the 
registers as follows: 


A Register 
X Register 
OV Register 
Word Mode 

LSI Console Data Register 


Undefined 

Pointing to the IOB 
Undefined 

Unchanged 


The format of a call to IOX to perform an I/O operation is: 

JST 10: Call the IOX perform I/O routine 

DATA (*)I0B Address of the Input/Output Block 

- Immediate Return 

- Operation complete-abnormal return 

- Operation complete-normal return 

Note that there are three exits from 10: — two are always taken. As soon as the 
request is processed, IOX BEGIN:'s a new task whose starting address is the immediate 
return location. When the I/O operation is completed, IOX returns to either the 
abnormal or normal return depending on the success of the operation. Having an 
immediate exit as well as a complete exit from IOX provides the user with the option 
of concurrently executing his program while the I/O is in progress. If he does not 
wish to continue execution until the I/O has completed, he simply codes: 


in the location of the Immediate Return. 

Alternatively, if a certain amount of concurrent processing can take place during the 
I/O operation, the immediate return location should contain a jump to the processing 
routine. When the intermediate processing has finished, and it is necessary to await 
I/O completion before continuing, a call to the IOWAT: routine is made, as in the 
following example: 


10 : 

(*)IOB 
TAG 
END: 
END: 

$ 


Initiate the I/O operation 
IOB address 

Immediate return - continue processing 
Ignore complete return 
Ignore complete return 


Concurrent processing 
during I/O 


IOWAT: 

(*)IOB: 


Wait until I/O completion 
IOB address 

Operation complete - abnormal return 
Operation complete - normal return 


Note- that a call to END: must be made at the "complete" returns from the call to 10:, 
.in order to terminate the I/O task. One of these two returns will be made if I/O 
completes before the call to IOWAT: is executed. 
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A call to 10: is equivalent to a call to BEGIN: (see chapter 1, 
RTX Functions) with a starting address of the immediate return and 
a priority of the task which calls 10: except that the new task is 
queued before all tasks of equal priority. 

An abnormal return may result due to the following: 

LUN not in UAT 

Illegal Operation Request 

Device Error 

File Mark Input 

End-of-Device 

A normal exit will result from all other conditions. 


1.3 DEVICE DEDICATION 

If desired, the user may dedicate a device to specific 10: calls only. Word 3 of the 
IOB provides the capability of establishing a specific (non-zero) coordination number 
for an I/O call. Once such a call has established the dedication of a device, all 
future I/O requests for that device will be held off (queued) until the device is 
released, unless they contain the established coordination number, c 

A device is released from dedication by a call to the IOREL: subroutine, as follows: 

JST IOREL:: 

DATA (*)IOB 

- Return 

On return the A register will be zero if the device was released; otherwise, one or 
more of the following A register bits will be set: 

Bit 0 set: the LUN entry in the IOB could not be found in the UAT. 

Bit 1 set: the IOB contains a coordination number of zero. 

Bit 2 set: the coordination number in the DIB does not match the coordination 

number in the IOB and no queued IOB has a matching coordination 
number. 


1.4 LOADING 

The user is supplied with two standard relocatable object segments, each residing on 
two separate paper tapes: 

Segment 1 (paper tape 70-93300/1-01): 

This segment contains the following program modules, in the order shown: 

1. Character I/O Drivers 

2. Card Reader Drivers 

3. Magnetic Tape Drivers 

4. Disk Drivers 
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5. I/O Scheduler 

6 . RTX Nucleus 


Segment 2 (paper tape 70-93300/1-02): 


This segment contains, in the following order: 


1. ZBG 

2. IOX Control 

3. RTX Services 

4. CNSOL3 (If LSI-3 Version) 


In addition to these two modules, the user will require: 


1. An RTX Mainline sequence, which makes a call to RTX: to initialize the RTX envi¬ 
ronment, and to BEGIN: for each task he wishes to initiate immediately. 

2. One or more "task" programs to be run simultaneously under RTX (See chapter 1, 
RTX Description) 

3. Special device handler program(s) and the associated DIB and CIB tables, for use 
in communicating with any device(s) for which a standard handler does not cur¬ 
rently exist in IOX (see section 3, I/O Handler Organization below). These 
handler programs are not necessary if using only the standard devices (teletype, 
CRT, high speed paper tape reader and punch, line printer, card reader, magnetic 
tape, disk, floppy disk). 

I NOTE I 


The user’s special DIB’s will each contain a CHAN directive to permit 
chaining to the other DIB’s referenced during linking. The user 
who does not have an OS system will need version DO or higher of 
the OMEGA assembler in order to correctly assemble the DIB tables, 
because lower versions do not recognize the CHAN directive. 

4. A Unit Assignment Table module (UAT) containing entries for each I/O unit to be 
accessed (see section 2, UAT Description). 

The user may either load each module using LAMBDA, or produce a binary tape via the OS 

Link Editor. The order of input of the object modules is, as follows: 

1. User's main line sequence. 

2. User's various tasks. 

3. Unit Assignment Table (UAT). 

4. Special user-coded DIBs and CIBs, if any. 

5. User'-coded I/O handlers, if any. 

6. RTX/IOX tape. Segment 1. 

7. RTX/IOX tape, Segment 2. 


The RTX/IOX tapes. Segments 1 and 2, are organized in library format. Each routine on 
these tapes is loaded conditionally until the last module of the tape is read. The 
routines are organized so that only one pass through the loader is necessary. 
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Fortran tasks to be run under RTX control require additional library 
modules to be linked. Refer to the Fortran Operations Manual for a 
complete description. 

1.5 RESTARTABILITY 

In general, if some I/O error occurs during execution for which the operator wishes to 
abort the program, it may not be restartable if the abort condition (e.g. , the operator 
halts the processor through the console) occurs during the period of any I/O request 
(either pending or being serviced). This is because various "busy" flags within the 
I/O tables must be reset upon restarting the program. To insure resetting of these 
flags, reference the "IONIT:" module from the Mainline sequence (see chapter 1, 
section 2: description of the RTX: initialization routine). 
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SECTION 2 

IOB AND UAT ORGANIZATION 


The IOB (Input/Output Block) is created by the user and resides within the calling 
task. It contains the Logical Unit Name or Number (LUN) as well as specifications for 
the I/O operation to be performed. 

The UAT is also created by the user. It is a series of two-word entries, each of 
which equate the LUN (specified in the IOB) to a specific device. 

The following IOB description applies to all standard IOX handlers. The description 
is annotated to include File Manager functions- IOB organization for non-standard 
handlers (for example, the IEEE Intelligent Cable Handler) is described in Section 7. 

2.1 INPUT/OUTPUT BLOCK (IOB) - 10 WORDS 

The IOB must be set up by the user within his own program. Word 0 is temporary 
storage and will be destroyed by IOX each time 10: is called. Words 1 and 2 are set 
to the device name by 10:. Words 3-7 are parameters passed by the user on calls to 
10:. Words 5 (bits 8-15) and 8 contain information returned to the user from IOX. 

Word 9 is used only on devices which support direct access I/O (i.e., disk, floppy 
disk). (Note that IOB tables are not required for Fortran tasks. Refer to the 
Fortran Operations Manual). Figure 2-1 illustrates the IOB configuration. 

Sample IOB's are included in TASKl, TASK2, and TASK3 of the RTX Demo Program. Refer 
to Chapter 1, Section 6. 


Word 0 


Word 1 


Word 2 


Words 1 and 2 are used for temporary storage during calls to 10: and 
are only valid after one of the complete exits has been taken. These 
locations must not be changed when the busy bit in word 5 is set. 


Temporary Storage for Use by IOX. This word is used by IOX as a 
pointer to queue requests for each device. It must NOT be altered by 
the user. 


Device Type (Two ASCII Characters). This word is set by 10:. It 
contains the two character mnemonic for the device type. 

Device Number. This word is set by 10:. By convention it contains two 
ASCII digits (0-9) and is used to distinguish between multiple devices 
of the same type. 
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INPUT/OUTPUT BLOCK 

Standard 

Name* 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


IDT 

ICUN or 
ITCB 

C.N 

ILUN 

ISTA,IOP 

IRCNT 

IBUFF 

IACNT 

IDAA 


* refer to the I/O Handler listing at the end of Section 3. 


CHAIN POINTER (RESERVED FOR USE BY IOX) 


DEVICE TYPE 


DEVICE NUMBER 


COORDINATION NUMBER 


LOGICAL UNIT NAME/NUMBER 


B 

U 

E 

R 

NO 

BAD 

F 

0 

DEV. 

DEVICE 

INT. 

RES. 

S 

OP 

OP 

S 

Y 

K 

0 

R 

I/O 

LUN 

R 

M 

UN- 

RESP 

POS. 

USE 


0 

CODE 

MOD. 


REQUESTED COUNT 


BUFFER ADDRESS 


F 

L 

A 

G 


ACTUAL COUNT/PROMPT CHARACTERS 


DIRECT ACCESS ADDRESS 


Figure 2-1. IOB Configuration 


Word 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 
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Word 3 I/O Coordination Number. This word is supplied by the user to 

coordinate his I/O requests. If this word is non-zero, the device on 
which the call is being made will be dedicated to the coordination 
number supplied. When a device is dedicated to a specific coordination 
number, only those requests with matching numbers will be honored. All 
others will be queued until the device is released. If device dedi¬ 
cation is not required, this word should be set to zero. 

Word 4 Logical Unit Name/Number (LUN) . This word is supplied by the user and 

it describes the Logical Unit on which the I/O should take place. 
Although the LUN may be any 16-bit value, by convention all negative 
numbers are considered to be ASCII character pairs (e.g., SI, LO) . All 
positive numbers are considered to be FORTRAN unit numbers (e.g., 
5,6,10). 


Word 5 Status, Function Code. This word uses the following format: 



Bits 15-8 Status returned to the user by IOX. The breakdown of bits is as 

fellows: 

Bit 15 Busy (the operation has not been completed) 

Bit 14 Error (an unrecoverable error has occurred); or bit 11 or 12 is 

set for the File Manager. 

Bit 13 No I/O performed (e.g., LUN is assigned to dummy device, device 

cannot perform the requested operation, LUN not in assignment 
table. Read or Write with zero (0) count). 

Bit 12 Invalid LUN (LUN cannot be found in Unit Assignment Table); or 

File Manager access mode error. 
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Bit 11 


Bit 10 


Bits 9 
and 8 

Bit 7 

Bits 6 
and 5 

Bits 4-0 

Bit 4 

Bits 3 
and 2 


Bits 1 
and 0 
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Bottom of form (listing device only)? or File Manager end of 
medium, directory full, directory error, device not labeled or 
partition busy. 

Device unresponsive (the device has not responded to the request 
in a reasonable length of time); not used by the File Manager. 


Position of device: 

00 Indeterminate 
01 Beginning of device 

10 File mark found 

11 End of device (disk and Magnetic tape only) . For tape, the 
EOT reflective marker was encountered. For disk, the last 
sector in the extent was accessed. This status does not 
necessarily mean that no data was transferred. 

This bit is for INTERNAL use only. Initialize to zero and 
do not ALTER. 

Reserved for future expansion 


Requested Function Code. This is supplied by the user and defines 
the operation to be performed on the device. The breakdown of 
bits is as follows: 

Special Operation - If this bit is set, bits 3-0 are ignored. 

This is to allow users to supply drivers for devices which perform 
special functions. 


Operation Code 
00 Read 
01 Write 

10 Position 

11 Function 


Operation Modifier - These bits define the specific type of 
operation to be performed. Their meaning depends on the operation 
code. (Some operation modifiers vary for certain Handlers. These 
differences are noted accordingly.) 


For 

read: 

File Manager 

00 

Direct Access (MTIC only. Read Reverse) 

Random Access 

01 

Unformatted, Sequential 

Sequential 

10 

Formatted ASCII, Sequential 

Sequential 

11 

Formatted Binary, Sequential 

Sequential 

For 

write; 

File Manager 

00 

Direct Access 

Random Access 

01 

Unformatted, Sequential 

Sequential 

10 

Formatted ASCII, Sequential 

Sequential 

11 

Formatted Binary, Sequential 

Sequential 
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For position: 

00 Absolute, Records 

01 Absolute, Files 

10 Relative, Records 

.11 Relative, Files 

For function: 

00 Write File Mark 

01 Punch leader 

10 MTIC only. Control Edit; Line 
Printer only. Eject to Top-of-Form 

11 MTIC only. Control Erase 



File Manager 
No change 
Reserved 

Set file deleted 
bit in DIB 
Update directory 
(New files only) 


Word 6 Requested Count. This word is supplied by the user to specify the I/O 

length, which is defined as follows: 

For read or write functions, this word is the number of bytes to be 
transmitted (1 to 65,535). (If the operation is Write Formatted ASCII, 
IOX will alter the requested count to remove trailing blanks before 
calling the handler. This is done with an intermediate counter. IOB 
Word 6 is not altered.) . . .. 

For relative record or relative file positioning, this word is the 
number of records or files to skip. (A positive count means skip 
forward, a negative count means skip backward). 

For absolute record or absolute file positioning, this word is the 
actual record or file number to skip to. (For MTIC Handlers* the unit 
is rewound and placed offline if this word is equal to minus one.) 

NOTE: Positioning a file to absolute -1 (file marks or records) is a 

close file operation for-the File Manager (refer to Section 5.1.3). 


Word 7 Buffer Address. This word is supplied by the user to specify the start 

address of the I/O buffer. Note that this address is always a word 
address and that indirect addressing is not allowed. 


Word 8 Actual Count/Prompt Characters. This word is returned to the user by 

the File Manager. It contains the number of records or files actually 
skipped (for relative position), the actual record or file skipped to 
(for absolute position), or the actual record length in bytes (for read 
or write). The File Manager will NOT read more bytes into the user's 
buffer than requested, but will continue to count characters to estab¬ 
lish the physical record length. 

On devices which are capable of prompting, this word is used to hold up 
to two prompt characters. 



Word 8 contents will be assumed to be prompt characters if 
negative (bit 15 set). Bits 7-0 not equal to zero indicate 
two prompt characters; bits 7-0 equal to zero indicate only 
one prompt character (in bits 15-8). 
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Word 9 Direct Access Address. This word is the direct access data address 

within the device (current record number), for devices capable of 
supporting direct access. For sequential access, this word will be 
incremented to the current logical record number after each access. 
For random access, the user stores the logical record number here. 


2.2 UNIT ASSIGNMENT TABLE (UAT) 

The Unit Assignment Table is not part of the standard IOX library; it must be "tailor- 
made" by the user for the particular configuration of devices he requires. Figure 
2-2 illustrates the UAT configuration. 


UNIT ASSIGNMENT TABLE 


15 0 word 



Figure 2-2. UAT Configuration 


The UAT is a table of two-word entries for each logical unit which can be referenced 
in calls to IOX, plus a terminating word containing the UAT word length. The first 
word of the entry is the Logical Unit Name/Number (LUN) which is referenced in the 
user's IOB. It may be any value from 0 to 65535. 

The second word of the entry is the address of the corresponding DIB table. 

The last word in the table is the count word. It is a negative quantity representing 
the number of words in the table, plus one; that is, two words for each entry, plus 
the count word itself, plus one. Thus, if there exist four two-word entries, the 
contents of the count would be minus 10, or -(4 x 2 + 1 + 1). The count word must be 
the last word in the table, and must be labeled I:UAT, because this is the name used 
by IOX when referencing the UAT. (Refer to the sample UAT at the end of this section 
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2.3 STANDARD DIB NAMES 

The following table shows the DIB names for all 

devices for 

which standard and 

non- 

standard handlers exist within I OX. The label 

is to be used as the 

second word 

of the 

UAT entry for each device the user wishes to include. 

Non-DIO 

Fortran 

Non-DIO 

DIO 

Fortran 

DIO 

Teletype Console 

D:TY 00 

DsTYFO 

D: TY 0D 

D:TYFD 

Teletype Keyboard 

D:TK00 

D:TKF0 

D:TK0D 

D:TKFD 

Teletype Tape Reader 

D:TR00 

D:TR00 

D:TR0D 

D:TR0D 

Teletype Punch 

D:TP00 

D :TP00 

D:TP0D 

D:TP 0D 

CRT Console 

D:TY00 

D: TYF 0 

D :TV0D 

— 

CRT Keyboard 

D:TK00 

D:TKF0 

D:TV0D 

— 

High Speed Paper Tape Reader 

D:PR00 

D:PR00 

D:PR0D 

D:PR0D 

High Speed Paper Tape Punch 

D :PP00 

D:PP00 

D:PP0D 

D :PP0D 

Centronics Line Printer 

D:LP 00 

D:LPF0 

D:I*P0D 

D:LPFD 

Tally Line Printer 

D:LP10 

D: LPF1 

— 

— 

Data Products Line Printer 

D:LP 20 

D: LPF 2 

— 

— 

Card Reader 

D-.CR00 

D:CR00 

D :CR0D 

D-.CR0D 

Disk (43 series, fixed platter), unit 0 

D:DK00 

D:DKF0 

— 

— 

Disk (43 series, fixed platter), unit 1 

D:DK02 

D:DKF2 

— 

— 

Disk (43 series, fixed platter), unit 2 

D:DK04 

D :DKF4 

— 

— 

Disk (43 series, fixed platter), unit 3 

D:DK06 

D :DKF6 

— 

— 

Disk (43 series, removable platter), unit 0 

D:DK01 

DrDKFl 

— 

— 

Disk (43 series, removable platter), unit 1 

D:DK03 

D :DKF3 

— 

— 

Disk (43 series, removable platter), unit 2 

D:DK05 

D :DKF5 

— 

— 

Disk (43 series, removable platter), unit 3 

D:DK07 

D.-DKF7 

— 

— 

Storage Module Disk, unit 0 (cylinders 0-201) 

D:SM00 

D: SMF 0 

— 

— 

Storage Module Disk, unit 0 (cylinders 202-403) 

D:SM01 

D:SMF1 

— 

— 

Floppy Disk, unit 0 

D:FD00 

D: FDF 0 

— 

— 

Floppy Disk, unit 1 

D:FD01 

D: FDF1 

— 

— 

Floppy Disk, unit 2 

D:FD02 

D: FDF 2 

— 

— 

Floppy Disk, unit 3 

D:FD03 

D :FDF3 

— 

— 

Magnetic Tape, unit 0 

D:MT00 

D:MT00 

D :MC00 

— 

Magnetic Tape, unit 1 

D:MT01 

D:MT01 

D:MC01 

— 

Magnetic Tape, unit 2 

D:MT02 

D :MT02 

D:MC02 

— 

Magnetic Tape, unit 3 

D:MT03 

D :MT03 

D:MC03 

— 

IEEE Intelligent Cable 



D:IEOD 
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2.4 SAMPLE UAT 

When creating the UAT, the user must declare I:UAT in a NAM directive, and any of the 
Standard DIB names in an EXTR directive, e.g.: 


UATTOP 


IsUAT 


NAM 

I :UAT 

EXTR 

DsCROO, D:LPOO 

DATA 

*CR' 

DATA 

D:CR00 

DATA 

1 LP 1 

DATA 

D:LPOO 

DATA 

f cr 

DATA 

D:TKOO 

DATA 

'CO* 

DATA 

D:TKOO 

DATA 

5 

DATA 

D:CROO 

DATA 

6 

DATA 

DrLPFO 

DATA 

UATTOP-I:UAT-2 


D:TKOO, DrLPFO 

Card Reader Entry 

Centronics Line Printer Entry 

Command Input Entry 

Command Output Entry 

FORTRAN Unit 5 

FORTRAN Unit 6 

Table Length 
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SECTION 3 

I/O HANDLER ORGANIZATION 


The purpose of an I/O handler routine is to set up and execute the actual I/O instruc¬ 
tions (normally interrupt-driven Auto-I/O instructions) necessary to perform an input 
or output operation to a specif ±ed device. The I/O operation and the Logical Unit 
Name/Number are specified in the user's IOB, and the I/O must be performed within the 
constraints of the device as specified in the CIB and DIB. (These tables are des¬ 
cribed fully in section 4.) A listing of the Character-oriented I/O handler is 
included at the end of this section. 


3.1 THE STANDARD HANDLERS 

Each standard IOX handler is described below. Refer to Section 7 for descriptions of 
non-standard handlers and to Publication No. 93325-00 for the A/D, D/A Handler. 

3.1.1 Character-oriented Device Handler (non-Fortran) 

This handler performs I/O, according to specifications within the applicable CIB, 
for the teletype, high speed reader and punch, and line printer. (A complete 
listing of this handler is found at the end of this section.) 

3.1.2 Fortran List Device Handler 

This handler exists for I/O to the teletype console, teletype keyboard and line 
printer when used as a list output device under Fortran. It differs from the 
previously described handler in that it recognizes and processes Fortran carriage 
control characters; i.e., a "1" character as the first print character signifies 
top-of-form, and a *0* signifies double spacing before printing. (A top-of-form 
function to the teletype consists of six consecutive line feeds). 

Note that the Fortran task does not use an IOB, but rather Fortran I/O state¬ 
ments; these are passed through the Fortran/RTX I/O Interface routine which sets 
up an internal IOB for the user, according to the DIB's he has included in his 
Unit Assignment Table. The Fortran I/O handler is entered because the third 
character of the device name in DIB Words 5 and 6 is an "F"; thus "LPFO" will be 
processed by the Fortran handler, and "LP00" will be processed by the standard 
character handler. 

3.1.3 Card Reader Handler 

The card reader handler is similar to the standard character handler except that 
input characters are converted to ASCII before returning. 
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3.1.4 Magnetic Tape Handler 

The Magnetic tape handler processes I/O for magnetic tape devices f and will 
perform read, write, write end-of-file and reposition functions. 

3.1.5 Disk and Storage Module Disk Handler (Non-Fortran) 

The IOX disk handler allows the RTX user to communicate with the disk. The 
communication takes place through IOX and the standard calling sequence is used. 

The user calls the IOX disk handler by making a standard call to IOX with an IOB 
which contains a LUN assigned to a disk DIB. The op-code must be either read- 
direct access or write-direct access. 

Data Formats 

The IOX disk handler supplies no formatting information of its own. It just 
reads (or writes) the number of bytes requested by the user. The length of each 
"record" is unknown (supplied by calling program) and therefore the disk handler 
is unable to read variable length records without some form of external format¬ 
ting routines. 

The IOX disk handler can support multiple "extents" on each disk and can allow 
access to them as if each were a separate disk unit. Extents are simply regions 
on the disk which may be defined by the user to be handled separately. Without 
any outside action by the user, IOX will process contiguous records throughout 
the extent. Each record contains the number of bytes requested in the I/O call, 
and each record starts at the beginning of a sector. Therefore, for fixed length 
records, each extent may be considered as a sequential file. 

In order to allow "direct access", each sector has a "relative sector number". 

The user may direct the IOX disk handler to process a particular record by ini¬ 
tializing IOB Word 9 (IOB Direct Access Address) in the IOB used for the I/O 
call. At the completion of each request, this address is appropriately incre¬ 
mented by the IOX disk handler so that the next request will process the next 
record. If the record contains 1-512 bytes, the address will be incremented by 
one; 513-1024 bytes, the address will be incremented by two; etc. Note that the 
relative sector number and relative record number may not agree (in fact they 
will not agree if the records are larger than 512 bytes). 

Extents are defined in the disk DIB's. The standard Disk DIB's (DK00 and DK01) 
define an extent as an entire platter (200 cylinders, 2 heads). The user who 
wishes to utilize several extents on a single platter may do so by creating his 
own disk DIB's, using the following variables within each DIB to define the 
parameters of the desired extent: 

a. The number of sectors per track (may be less than the physical number). 

b. The starting sector number (when added to the number of sectors per track 
must be less than or equal to the physical number per track). 

c. The number of heads per cylinder (may be less than the physical number). 

d. The starting head number (when added to the number of heads per cylinder must 
be less than or equal to the physical). 
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e. The number of cylinders the extent occupies. 

f. The starting cylinder (when added to the number of cylinders must be equal to 
or less than the physical). 

g. The drive number. 

The IOX disk handler does not check for validity of the resulting sector, head, 
and cylinder numbers. It assumes that the dimensions and offsets supplied in the 
DIB are valid. This allows the user to take advantage of the '’flag'* bits des¬ 
cribed in the Disk Interface Manual. 

Contiguous sectors occur in the following sequence: 

a. Consecutive sectors on a single track (up to the number of sectors per track). 

b. The same sectors on the next head (up to the number of heads per cylinder) . 

c. The same sectors and heads on the next cylinder (up to the number of cylin¬ 
ders) . 

The disk handler requires four additional words (five if under Fortran) in the DIB 
which are not required for the other handlers. These are DIB words 11-14, (11-15 
if under Fortran) and are described in section 4. 

3.1.6 Floppy Disk Handler (Non-Fortran) 

An "extent” on a floppy disk is constructed as described for the disk handler, 
taking into account the size limitations in the number of cylinders, heads, and 
sectors: 

Cylinders per Floppy Disk platter = 77 (00-76) 

Heads per platter = 1 (single surface) 

Sectors per track = 26 (00-25) 

Words per sector = 64 

There exists within RTX a standard Floppy Disk DIB (D:FD00) whose extent is 
defined as an entire pl&tter. The user may define his own DIB's as described in 
the disk handler description. 

3.1.7 Disk, Storage Module Disk, and Floppy Disk Handler (Fortran) 

Fortran tasks require a certain minimum amount of file management to be performed 
by the disk handler. The Fortran disk handler differs from the standard disk 
handler as follows: 

a. The random access address within the IOB is maintained by the Fortran disk 
handler itself, rather than the user, since the Fortran task does not create 
its own IOB. 

b. The Fortran disk handler can write and recognize an end-of-file mark. This 
is a 2-character ASCII record comprised of "/*" characters. 
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The determination as to whether a Fortran or a non-Fortran disk handler is to be 
used is made on the basis of the device name in Words 5 and 6 in the DIB. If the 
third character is an "F", it signifies Fortran, and the Fortran disk handler is 
used. 

In addition, a sixteenth word (Word 15) is required in a Fortran DIB. This word 
is used for storage of the current relatiye record number, which would normally be 
maintained in IOB Word 9. Since the Fortran user does not have access to the IOB, 
the Fortran/RTX I/O Interface routine keeps this information in the DIB. 

3.1.8 Magnetic Tape Intelligent Cable (MTIC) Handler 

The MTIC handler controls data transfers between Pertec or Pertec-compatible 
formatters and tape transports and the central processor. The handler performs 
read, write, write filemark, rewind and offline, control edit, control erase, and 
reposition functions. 


3.2 I/O HANDLER REQUIREMENTS 

The user may write his own handler routine for any type of I/O device he wishes. The 

requirements for any I/O handler to be run under control of IOX are as follows: 

1. Since all I/O under RTX must be done under interrupts, the word and block inter¬ 
rupt locations must be set up prior to I/O. 

2. A time-out sequence must be included to avoid the possibility of the device 
"hanging-up" indefinitely without completing its operations. The real time 
clock, via the RTX DELAY: call is normally used for this purpose. 

i N ° Tt 

The user must not attempt to manipulate the real time clock by 
any means other than through the DELAY: call, as this will 
adversely affect the operation of RTX. 

3. Once I/O is initiated, the handler should pass control back to the IOX scheduler. 
This permits other I/O operations to be executed simultaneously if requested. 

4. The I/O handler should resume control upon either an end-of-block interrupt or 
upon watchdog time-out, to check the status and return to the caller at either the 
normal or the abnormal return location. 

Several IOX- internal subroutines (described below) currently exist to aid the standard 

handlers in accomplishing the above requirements. The user-written handler may use any 
l of these routines he wishes. The names of any of these routines must be declared in 
' EXTR or REF directives within the user’s handler. 
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3.2.1 SINT: (Set up an Instruction at the Word Interrupt Location) 
Calling sequence: 

EXTR SINT: 


i 

! 

LDX CTB Address . | 

JST SINT: 

DATA :XXXX 

Returns with: 

INTERRUPTS-UNCHANGED 

STATUS-UNCHANGED 

A-REGISTER-UNDEFINED 

X-REGISTER-UNCHANGED 

j Where :XXXX represents a constant which is added to CIB Word 1 to form an interrupt 
| instruction: 


, SINT: does the following: 

I. . 

! 1. It determines the word “interrupt location of the device. This address must 
; reside in CIB Word 21. 

i 

\ 2. It calculates and stores an instruction into the word interrupt location. The 
j actual instruction stored is the arithmetic sum of (contents of CIB Word 1) + 

| (:XXXX), where :XXXX may be any positive or negative value. 

I H<> ” 

The standard CIB's contain a U SEL DA,7" instruction in word 1. 

i 

3. Preparation is then made for a subsequent call by the handler to the SIO: routine 
(the handler need not call SIO:, however). This preparation consists of trans¬ 
ferring the contents of DIB Word 8 into CIB Word 12. 

I ■-;■■■ - . , : . . .... 

| (In the standard DIB's Word 8 will contain various function codes which are required 
j for SELECT instructions in order to initiate an Auto I/O sequence during the SIO: 
routine. If the specific handler does not call SIO:, DIB Word 8 need not be preset.) 


3.2.2 SIO: (Start I/O and Watchdog Timer) 
Calling sequence: 

EXTR SIO: 


LDA DPTR 

LDX CIB address 

JST SIO: 
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Does not return directly; if the INTP: siabrdutihe is used, a return will ulti¬ 
mately be made in the following state: 

INTERRUPTS-ENABLED 

STATUS—WORD MODE OV RESET 

A-REGISTER-UNDEFINED 

X-REGISTER-CIB Address 


DPTR is an address pointer to a two-word information block: 

Word 1: Positive number of bytes to be transferred. 
Word 2: Word address of I/O buffer. 


(Note that the standard handlers use CIB Words 26 and 27 for this information) . 

The SIO: routine does the following: 

1. Negates the byte count pointed to by the A register, and stores it into the Word 
interrupt location plus one. 

2. Shifts the Buffer address pointed to by the A register to the left by one bit 
(converts to a byte address), then decrements the byte address and stores it into 
the word interrupt location plus two. 

I NOTE \ 


(Steps 1 and 2 above complete the three-word Auto I/O sequence. 

The AIN/AOT instruction itself may be generated by a call to SINT:) 

3. Calculates the delay count required for the watchdog timer, as follows (assume a 
ten millisecond Real Time Clock rate): 




a. The negative byte count created in step 1 is loaded into the A register. 

b. The contents of CIB Word 20 are stored in-line and executed as an instruction. 

c. The contents of the A register are then negated (converted to positive) and 
incremented by 1000. 


Steps a, b and c above compute the number of RTC "ticks" (normally 10 milliseconds 
each) to delay during the I/O operation. Since the number is constructed begin¬ 
ning with the byte count (step a) and incremented by 1000 (step c) the minimum 
delay possible is ten seconds, plus ten milliseconds for each data byte to be 
transferred. The purpose of step b is to permit a larger delay, if necessary. 

For example, CIB Word 20 can be set up by the user, when constructing the CIB 
prior to execution, to be a shift instruction (e.g., ”LLA 1") which would double 
the value in the A register, and thus cause a twenty millisecond delay for each 
data byte(plus the ten second constant). Note that the instruction in CIB Word 20 
is executed before the byte count in the A register has been converted from 
negative to positive, and before the constant 1000 is added. If the minimum delay 
(ten seconds, plus 10 milliseconds for each byte to be transferred) is adequate, 
then the instruction in CIB Word 20 should be zero (a no-op instruction). It is 
the responsibility of the user when creating the CIB table for his handler to 
determine how large a delay is required to permit completion of an I/O operation, 
and thus what instruction (normally LLA K, where K must be determined) is to be 
stored into CIB Word 20. 
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4. Sets up and executes the following I/O instructions: 


SEL DA, X 
SEL DA,5 
SEL DA,6 
SEL DA, Y 


Handler-determined function 
Set word transfer mask 
Set block transfer mask 
Handler-determined function 


X and Y represent the function codes in bits 15 through 13 and 12 through 10, 
respectively, of CIB Word 12. (These function codes were originally copied from 
DIB Word 8 in a prior call to SINT:.) Note that if Select instructions of func¬ 
tion X and/or Y are not required by the device, they can be organized in the DIB 
so that X=5 and Y=6, so that each is executed twice, or they can be set to a 
function code which has no meaning to the device, if such a code exists. 


NOTE 


If these function codes are all zero, it indicates an operation 
under Distributed I/O. 

If the device uses function codes 5 and 6 for other purposes than 
to set the transfer masks, the user may wish to perform the Select 
functions within the handler Itself, rather than calling SIO:. 

5. Once the Select instructions have been executed, a call to RTX DELAY: is made, 
carrying the calculated delay time described in step 3 above. 

6. If the Watchdog Timer expires before an end-of-block interrupt occurs, the in¬ 
struction in CIB Word 1 (normally "SEL DA 7") is executed to disable interrupts 
for the device, and the "Error" and "Device Unresponsive" status bits are set in 
the DIB, and control is then passed to the EOR: routine at EORST:. 


NOTE 


SIO: does not set up the end-of-block interrupt location. This 
must be done in the handler. 


3.2.3 INTP: (End of Block Interrupt Return Po:int.) 

The INTP: routine cancels the watchdog timer upon end-of-block interrupt, and passes 
| Control to the return address of SIO:. Thus INTP: is an extension of SIO:, and is 
\ intended to be used only in conjunction with SIO:. 


f 

\ 
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To call INTP: at end-of-block, the handler should, prior to calling SIO:, set up the 
following sequence at the end-of-block interrupt location: 

JST *$+i 

DATA TAG 


Example: 




EXTR 

INTQ:,INTP: 

TAG 

ENT 



JST 

INTQ: 


DATA 

$,0,0,0 


DATA 

INTP:,8180,0 


DATA 

CIB Address 


DATA 

TAG 


where TAG is a short calling sequence to the RTX INTQ: subroutine, which points to 
INTP: as the task to be queued. 

(The user should first familiarize himself with the RTX INTQ: description in chapter 1 
RTX Functions). 

The above description is the method used by the standard I/O handlers for end-of-block 
interrupts. For this purpose, the first 12 words of the applicable CIB may be used to 
Contain the calling sequence to INTQ:. 

For example, the following is a representation of the first twelve locations within the 
CIB for the line printer: 

C : LPU - L I N E PRINTER 


L0C 

INST ADDR 

LABEL 

MNEM 

OPERAND COMMENT 

0000 



NAM 

C: LP0 



J- 


EXTR 1NTQ:,1NTP:,1:READ,1:R1TE,1:FUN 



* 

•t JL JL 

k k k k k k k k k k k k k k k k k k k 


0004 

DA 

EQU 

4 


0042 

INTAD 

J- 

EQU 

: 42 



a. 

JU Ju JL, 

k k k k k k k k k k k k k k k k k k k 

0000 



REL 

0 


0000 

C: LP0 

EQU 

$ 

0000 

0800 

CIB 

ENT 


0001 

4027 


SEL 

DA,7 SELECT FC = 7 

0002 

F900 


JST 1 

INTQ: 

0003 

0003 


DATA 

$,0,0,0,INTP:,8180,0,CIB,CIB 

0004 

0000 




0005 

0000 




0006 

0000 





0007 

0008 1FF4 
0009 0000 
000A 0000 
000B 0000 
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{ 

j 

Note that the end-of-block interrupt location contains a JST into the CIB itself? Won; 

1 of the CIB is the SEL DA,7 instruction used by the SIO: routine. It is also executed 
at end of block, thus serving as a convenient method to turn off the interrupt masks 
following an I/O operation. 

Following this instruction is a JST to INTQ: followed by the required parameters, of 
which INTP: is the task to be executed. Note also that this sequence will automati¬ 
cally cause the X register to be loaded with the CIB address upon entry to INTP:. 


3.2.4 WAIT: (End of Record Delay Routine) 

Calling sequence: 

LDX CIB Address 

JST WAIT: 

Returns with: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A-REGISTER-UNDEFINED 

X-REGISTER-CIB Address 

The WAIT: routine utilizes the delay length specified in DIB Word 7 to delay a suffi¬ 
cient length of time at end-of-record to ensure that the device is physically ready to 
perform the next I/O request. (Generally, one character time is sufficient for this 
delay.) 

The routine loads the delay count from DIB Word 7 depending on the I/O instruction at 
the Word interrupt location? i.e., if bit 13 of the I/O instruction is on, it is as¬ 
sumed to be an output instruction, and bits 0-7 of DIB Word 7 are used as the delay 
count. If bit 13 of the I/O instruction is off, it is assumed to be an input instruc¬ 
tion, and bits 8-15 of DIB Word 7 are used as the delay count. Once the delay count is 
established, a call to RTX DELAY: is made? upon return from the delay, the routine 
exits to the caller. 


I 

j 

3.2.5 EOFQ: (End of File Check Routine) j 


Once an end-of-block interrupt has occurred, EOFQ: may be called as follows: 

LDX CIB Address 

JMP EOFQ: 

| This routine does the following: 

| 1. Examines the first two input characters in the buffer to determine whether they 
| are 1 /*' 

! 2. If so, control is passed to the EOF: routine. 

I 3. If not, control is passed to the FOR: routine. 


i 


j 

$ 


i 

i 

j 
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3.2.6 EOF: (End of File Routine) 

Calling sequence: 

LDX CIB Address 

JMP EOF: 

The EOF: routine is entered when it has been determined that an end-of-file has been 
encountered (the routine EOFQ: may be used to determine this) . 

The routine stores a zero value into CIB Word 28, loads the A register with an end-of- 
file status, and transfers control to the EOR: routine at EORST:. 


3.2.7 EOR: (End of Record Routine) 

Calling sequence: 

LDX CIB Address 

JMP EOR: 

This routine is entered when the handler has completed the requested I/O operation and 
wishes to return to the calling task. 

The routine loads the A register with the current status from CIB Word 32, and con¬ 
tinues at EORST:. 


3.2.8 EORST: (Alternate Entry Point to EOR:) 

(EORST: and EOR: are alternate entry points to the same end-of-record routine. The 
difference between the two is that EOR: loads the I/O status word into the A register 
from the CIB. EORST: assumes that the status is already in the A register. 

Calling sequence: 

LDX CIB Address 

LDA I/O status (from handler) 

JMP EORST: 

The routine does the following: 

1. It copies the actual transfer count of the I/O operation from the CIB into Word 8 
of the IOB. 

2. It stores the status of the I/O operation (in the A register upon entry) into 
bits 15-8 of IOB Word 5. 

3. It performs an RTX BEGIN: call, passing as a parameter the normal or abnormal 
return address of the caller, depending on the status. The abnormal return 
address is taken if any of bits 9, 10, 11, or 14 are set in word 5 of the IOB. 

4. It calls WAIT: to perform an end-of-record delay. 
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5. It loads CIB Word 1 (assumed to be "SEL DA,7), masks off the liw order two bits 
(to make it a SEL DA,4 or initialize instruction) and executes j it in-line. 

6. It empties the IOCH (I/O suspend) list into the READY list. 

/ 

7. It then transfers to the IOX request scheduler routine to 6heck to see if another 
request is pending for any device on the controller just used. 

3.2.9 FETCH: (Input one character from an I/O device) 

Calling sequence: 

EXTR FETCH: 


LDA CIB Address 

JST FETCH: 

Returns with: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A-REGISTER-CONTAINS INPUT BYTE 

X- REG ISTER-UNCHANGED 

The FETCH: routine calls WAIT: to wait one character time, then calls SIO: to perform 
a one-character I/O operation. Upon input of the character, it is checksummed, and 
the subroutine exits back to the caller. 

The following assumptions are made by FETCH:. 

1. The handler has previously zeroed out the checksum word (CIB Word 13) at the 

start of the record. 1 


2. There exists in CIB words 34 through 37 the following sequence: 


DATA 

$+1 

Pointer to byte count 

DATA 

i 

Byte count (1 character) 

DATA 

$+i 

Buffer address 

DATA 

0 

One-character input buffer 


which are required for FETCH:'s call to SIO:. 

Upon return from FETCH:, the input character is in CIB word 37 as well as in the 
A register, and the cumulative checksum is in CIB word 13. 
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3.2.10 BUFFQ: (Store input character into buffer) 
Calling sequence: 

EXTR bIfPQ: 


LDX CIB Address 

JST BUFFQ: 

Returns with: 

INTERRUPTS-ENABLED 

WORD MODE 

OVERFLOW-RESET (unless buffer filled) 

A-REGISTER-CONTAINS INPUT BYTE 

X-REGISTER-UNCHANGED 

The BUFFQ: routine is designed to be used following a call to FETCH:/ in that it moves 
CIB word 37 (stored into by FETCH:) into the user's buffer. The step-by-step procedure 
is: 

1. The overflow register is reset. 

2. The actual transfer count (CIB Word 28) is incremented. 

3. The actual transfer count is compared to the requested count (CIB word 26). 

4. If the actual count is greater (indicating that the buffer is already full)/ the 

buffer address (CIB Word 27) is incremented and the subroutine exits. 

5. If the actual count is less, CIB Word 37 is copied into the user's buffer pointed 
to by CIB Word 27. Then Word 27 is incremented and the subroutine exits. 

6. If the actual count is equal (indicating that this character will cause the 
buffer to be full), overflow is set and CIB Word 37 is copied into the user's 
buffer pointed to by CIB Word 27. Then Word 27 is incremented and the subroutine 
exits. 


3.2.11 UNRES: (Unresponsive Device Routine) 
Calling sequence: 

EXTR UNRES: 


LDX CIB Address 

JMP UNRES: 

The UNRES: routine may be called when a "Device Unresponsive" status is returned. 
This routine masks off the lower two bits of CIB Word l f which converts it to a SEL 
4/ or initialize instruction/ and executes it to prevent any further interrupts, 
stores a zero count into CIB Word 28/ (the actual transfer count)/ loads the A 
register with an Error/Unresponsive status, and exits to the EORST: routine. 
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3.2.12 IORTN: (Return to I/O Scheduler) 
Calling sequence: 

EXTR IORTN: 


LDX CIB Address 

JMP IORTN: 

In practice, an I/O handler is a subroutine with an abnormal calling sequence (a JMP 
instruction is used, rather than a JST). This is because I/O handlers are only 
"called" from one location, and thus the return is known. This return address is 

IORTN:. Therefore, once an I/O operation has been initiated, a jump to IORTN: must 

be made. Note that if the SIO: routine is called, it will exit to IORTN:. 


3.3 CHARACTER-ORIENTED DEVICE HANDLER LISTING 

The following listing illustrates the standard Character-oriented Device Handler 
(non-Fortran) written for an LSI-2 processor. The code also includes a table of 
equates used by RTX, its subexecutives, and its library modules, as well as a listing 
of the TTY console DIB (D:TYOO) and TTY CIB (C:TYO) . CONCORDANCE listings provide 
an alphabetized map of all symbols. 
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5 i > M p W* | p 
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c 


( 


L_ A 


PAGF 00?? 

11/03/77 10:00: 

27 90500-10 PT* 

TOX, COMX EQUATES 


MACRO? (A?) 

SI = MACROS B0= 


NAMDEF 

MAfPU 


0636 


MACRO 

NAMDFF 



0637 

k: 

SET 

1 



0638 


REP T 

«? 



0639 


ND 

* 1,»?# *3, 

tin, AS» *6, #7, #8, *9, tt] o 


060 0 

PROT 

SET 

0 

PROTOCOL DRIVER SPECIFICATION 


0601 

ECHO 

SET 

0 

TTY ECHO OPTION 


060? 

EVEN 

SET 

0 

TTY EVEN PARITY OPTION 


0603 

ODD 

SET 

0 

TTY ODD PARITY OPTION 


0600 

discon 

SET 

0 

DISCONNECT ON FILE HAWK OPTION 


060S 

ASCTI 

SET 

0 

BSC-ASC11 CHARACTER SET 


0606 

EBCDIC 

SET 

0 

BSC-FBCDTC CHARACTER SET 


0607 

XL ATE 

SET 

0 

BSC-ERCDIC-ASCII TRANSLATION OPTION 

0608 

XPRNT 

SET 

0 

BSC-FIJU. TRANSPARENT OPTION 


0609 

IIXPPNT 

SET 

0 

BSC-UNFORMATTED WRITE=TRANSPARFNT OP TT < 

0650 

tJLC 

SET 

0 

RSC-USER LINE CONTROL OPTION 


0651 

SLAVE 

SET 

0 

BSC-SLAVE STATION OPTION 


0652 

WA T TCO 

SET 

0 

NAIT FOP CARRIER OFF OPTION 


0653 

CONSTC 

SET 

0 

CONSTANT CARRIFR OPTION 


0650 

SMC 1 

EQU 

1 

SYNCHRONOUS MODFM CONTROLLER - 

513 

0655 

SMC? 

EQU 

? 

SYNCHRONOUS MODEM CONTROLLER - 

617 

0656 

DMOOEM 

EQU 

3 

010 MODEM CABLE 


0657 

DTTY 

EQU 

0 

DIC? TTY CABLE 


0656 

DCRT 

EQU 

5 

DIO CRT CA6LF 


0659 

TTY 

EQU 

1 

TTY PROTOCOL DRIVER 


0660 

BSC 

EQU 

2 

BSC PROTOCOL DR T VF R 


0661 

OMAD 

EQU 

too 

DMA IOD FLAG 


066? 

HOP:C T 

SET 

0 



0663 


EMDM 




0660 

* 





0665 

* MAM DECLARE MACRO - 

ND 


0666 

* 





0667 


MACRO 

NO 



0668 


NAM 

0:*k : 



0669 

k: 

SET 

x: +1 



0670 


ENDM 






P A(SF 

Oft ft-? 

11/06/77 lorftft: 

? 7 (' 5 t v , f r »y - ru^x Mii^ If c 

*acro? 

f ft?) 

si= MACROS m "= 


Cl r "F MAL'KI 

067? 



MA O'D 

f .l i f-'F 

06 7 i 


* of r 

P A ft A ft S 


0 b 7 ft 



IF F 

fi ? < >, 

0675 



NO FF 

F'r’CI INF NACFl! Rf- (J| f J >’E S A f IfAST s ftApAAf- 

0676 



Fm|)C 


06/7 


OLD": 

SF T 

“ft i'FVFLF I.ON 

067H 


* Of I 

PPORF p 

DFvIl'f A 1 U ft f S S , Jf T AOC* Pf SS A .VO 1 1 ‘ f S»’F I ! 

0670 



F 

fi U 4 ( : 

A h R fi 


o F V AO): 

Sf T 

fc,J "sf St.'PfM If n ( f V 11 > Af.URCSS 

06»1 



Ff-or 


068? 



TFT 

a 5t 0 

06ft 3 


I ADD: 

SF T 

»6 "SF SIJPPI Ff " FvTFOfttiPI AUf-pf SS 

OhftU 



F N’DC 


OfcHft 



TFT 

tf 6 + ii 

0 66.6 


L I "F : 

SF F 

«6 

0 6 ft 7 



F.MOC 


0686 



IFF 

A 7 + 0 

06 ft 9 


SPFFD: 

SF T 

A 1 7 IJSf SUPPLIED Hft 0f) RATE 

0600 



fndc 


0691 


* Sf- T 

UP LINE 

: Tot N f I F I F ft PAF'ARf FI;PS 

069? 



PI in 

. ft ft o LESS » INF F Of NT IF Ff ft 

069} 


* CMFCK fop 

LEGALITY 

0690 



IFF 

DEV AD: 

0605 



no T F 

f t * n f- v t cF Annvcss o illf.i-.ai' 

06Q6 



Fp DC 


0697 



IFF 

1 add: 

0b9ft 



N0 T F 

F f ' FNTf RPOF’T An L*PF SS 0 FILFC.AI ' 

0690 



E NDC 


0700 



IFF 

SPF h D : 

ft 70 t 



NOTE 

F , ' l INF SPF F 0 0 II | F CM ' 

0 70? 



F NDC 


0 7 0 } 


* DPR 

SF T UP 

lift SMF r Aftf SF A T I.'S 

0 700 


ft: hdx 

SF T 

p : F !)* - t A 1 

0705 



POSH IT 

P:LCS,| SFCOD,F1 : SET LINE code 

0706 



POSH IT 

w A I TCO , LSFMCD,F ?: wftJT FOR CARRIER DFIFCI 

0707 


CC: 

SF 1 

COnSTC- 1 X. t 
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PAGF 0020 11/03/77 10:00:27 9«S00-10 RTX, IOX, COMX EQUATES 


• MACRO? 

(A?) SI= MACROS R0 = 

CLINE 

MACRO 



j 0708 

posbit 

CC:,LSFCTY,T3: CONTROLLED CARRIER 

\ 

' 0709 

POSBIT 

SNITCH, 

LSFANM,TO? SWITCHED LINE 

i 

; o7io 

POSRIT 

SYNC:,LSFMTV,T5: SYNC 

MODEM TYPE 

j 

; o7ii 

POSRIT 

HDX:,LSFLDX,T6: HALF 

DUPLEX LINE 

‘ 

! 0712 

POSRIT 

p:hdx,l 

SFPDX,T7 : HALF 

DUPFX PROTOCOL 


[ 0713 

SOFS: SET 

TUJT2: 

?T3:;toj;t5:;T6: 

;T7: 

j 

! 0710 

* 




* 

; 0715 

* NOW GENERATE PROTOCOL TABLES 


1 

0716 

* 





? 0717 

* CIB 




! 

? 

* 0718 

* 




J 

{ 

j 0719 

PIC IB SET 

$ 



i 

! 0720 

DATA 

0 

CBOR 


i 

i 

; 0721 

RES 

9,0 

JOB 


t 

i 

f 0722 

RES 

10,0 

ENTRY ADDRESSES, ETC. 

j 

* 

0723 

DATA 

PjFLGS 

FLAGS WORD 


i 

j 0720 

DATA 

0 

MASTER TABLE ADDRESS 

l 

i 

i 

! 0725 

RES 

PsLCIB- 

CPTBL-1,0 



0726 

* END OF CIB 



j 

\ 0727 

* 




< 

# 

{ 0728 

* PROTOCOL 1 

DIB 



l 

; 0729 

* 




» 

? 0730 

PIDIR SET 

S 



.* 

0731 

D:#l EGU 

$ 



4 

0732 

CHAN 

Xs : 

DIB CHAIN 


5 

; 0733 

DATA 

PICIB,0 

,0 DC IB, QUEUE, 

CN 

\ 

’ 0730 

DATA 

P:osw 

DSW 


i 

» 0735 

DATA 

PJDVTP 

DT 


%■ 

V 

f 

S 0736 

DATA 

•00' 

OCUN 



J 0737 

DATA 

0 

ODE L 



| 0738 

DATA 

0,0 

DFIIN, DULS 


* 

! 0739 

DATA 

pjdflg. 

P;BLKS,P:LPRM 

DPFLGS,DBLKS7, 

DLPA*« 

! 0700 

DATA 

0, 0 

DIXLTR,DOXLTR 


i 

0701 

CLIJN 

DLUNS 

DLUN 



0702 

CHAN 

0:#i 

DO IB 


l 

0703 

RES 

3,0 

DSRTN, DTMPt, 

DTMP2 


»** xjur-v^ nmmm 
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PAGF on PS 1 1/OS/// 1 ! 1 T ; P 7 t 0 t> T < 9 f f x g { p i 

M AC» f J? (A?) Ms HACK'S »*•* ri I;M«- ‘•■ACt'f 


0 7 0a 


r a t .4 

P ; f; K S P | > r K c 

0 7 o s 


tf r 

p : r k F r; 

0 746 


* ■ a r a 

p;rKFn r P: l^sp 

0707 


ENDC 


0 7 4 M 


TFF 

p : C h p g 

C749 


0 i T A 

o , 0 , 0 

0 7 SO 


E '--DC 


0 7S 1 


f>A r 4 

rt»)p: r i 

07 S2 


TFT 

Mp* : ri>n 

07S3 


F OPM 

P Y T F S ,» ,* 

07S4 


SVTFft 

mOh: c l,Hi'iPtc? 

07SS 


[F r 

WOPJCT>2 

0756 


r, r T F S 

pop : c i, Hi'p: r a 

0 7 S 7 


I F T 

pop: c t > n 

0.75 ft 


n y T F $ 

h o p : rs , h o p • c b 

0759 


IFT 

h o y : r T > 6 

0760 


BVTFS 

hop : c 7 f hop: r. ft 

0 76 1 


IFT 

H()P:CT>« 

0 762 


h Y TF8 

HiiPjr9 ,ca 

0 76 3 


Fk DC 

n >0 

0 76 4 


O Of; 

C T >? 

n?6S 


F v|)C 

(, T > 0 

0766 


PMor 

r T > 6 

0767 


c vnr 

r T >H 

076ft 

* F ft 

_ . r PP|'l T 

'KM T API f ft 

076« 

* 



0770 

* 

CF \J Iff 

r A ft| F S 

0771 

* 



077? 

* t T 

if- FijFFFF 


0773 

* 



0774 

T PDF 

T 

V 

0 775 

JF 

SEI 

fc 

0776 

T1: 

SF T 

ft p F h i ■: < 1 6 o o 

0777 

T?: 

SFT 

PFfOTzTTY 

077ft 

T 3: 

sf r 

PSOCM-lfcl 

077° 


TFT 

TI:KT?rRT3: 



F Ql i A I f s 


DO ftF , no SP, r ( k ft A 



( © 
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PAGE 

00?6 

11/03/77 10:04: 

27 Q/U500- 1 0 RTX 

, IOX, (<)<*X F DO A TF $ 

WACKO? 

(A?) 

ST = MACROS 80 = 


CLINE MA CRO 

0780 



RES 

2,0 

? WORD PUEFFR IF SLOW TTY 

0781 



ENDC 



078? 



IFF 

T1:&T?:&T3: 

0783 



RES 

P:maxt/2, 

0 FULL BUFFER 

0784 



ENDC 



078S 


F.BUFF 

SET 

% 


0786 



DATA 

0 

BUFFER OVERFLOW WORD 

0787 



IFT 

P:FDX&FDX 

:&P:OCM 

0788 


OBUF 

SET 

% 


0789 



RES 

P:MAXT/2, 

0 OUTPUT BUFF F R FOR FULL DUX 

0790 



ENDC 



0791 


* 




079? 


* 




0793 


* OUTPUT CIB 



0794 


* 




0795 


OB IRA 

SET 

s 


0796 



XD 

sch: 

CHOR 

0797 



EXTR 

TNTQS: 


0798 



SPAO 

INTQS: 


0799 



JST 

Intqs: 


0800 



DATA 

$ 9 0 .9 0 f 0 


0801 



DATA 

0 


080? 



DATA 

CINPRI 


0803 



DATA 

0,08IR A,DR T RA 

0804 



LDX 

W 


0805 



JMP 

*0RIRA + C TNRTN JUMP TO INTERRUPT ROUT 

0806 



DATA 

-1 

CTIMER 

0807 



DATA 

L :»3 

CLIP 

0808 



RES 

5,0 

DRIVER ENTRIES 

0809 



DATA 

0 

CINRU’ 

0810 


DOC IB 

SET 

$ 

OUTPUT CIB ADDR = INPUT CTB 

0811 



IFT 

P: FDX&FDX 

• 

• 

081? 


DOC IB 

SET 

OBTRA 

REAL OUTPUT CIR 

0813 



RES 

L :DOCB-CDSRTN,0 

0814 



ENDC 



0815 


* END 

OF OUPUT CIB 
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FA OF 

0 02 / 

11/03/77 10:04: 

?1 9.'jS 0 0- t 0 

FT X, lux, rUMX FMUAT( S 

macro,? 

( A?) 

SJ = MACROS 80= 


( I. 7 Of MACRO 

O* J h 


* 




0617 


* input cip 



OhlF 


* 




OF 1 9 


0ICI8 

SET 



O8?0 



XD 

S Cm: 

CM OH 

08? 1 



f X TP 

iutus: 


Ob?? 



SPAR 

tntqs: 


0 «p? 



JST 

I NT0$• 


0R?a 



DATA 

1,0,0, 

0 

0825 



DATA 

n 


0826 



data 

C INPR1 


0R27 



DATA 

0 , DTC T 0, DTC I 8 

08?8 



1 DX 

%-? 


(,p?q 



JMP 

* D I C I H 

+ C f'P T u JUMP TO |NT IRRUPT 

a«3o 



DATA 

-1 

c nn u 

0831 



DATA 

l:«3 

CLIP 

0832 



RES' 

5, o 

DRIVER P h T R 1F S 

08 33 



DATA 

0 , 0 

CIUPTu, cdspT H 

08 34 



RFS 

C c H A I N 

-CDSPTN-1,0 

0 838 



CHAU 

C : c 18 

CIP Chain - cch a I Ki 

0836 



DAT A 

I hl )F 

CCCADP 

0837 



RFS 

L il'TCB' 

■» C C C h A P — 1 , o 

0 838 


* cun 

(IF INPUT CIP 


08 39 


A 




0840 



IFT 

H ! F U * U F D X t 


0841 

♦ fiUfPUT n JM 



08 4? 

* 




0843 

DUD IB 

SET 

$ 


0844 


Chan 

x:: 

Die ch/tn 

0845 


DATA 

DUC JH 

i > C I H 

0846 


DATA 

Of 0 

UUFlfF, f f 

0 8 (i 7 


0 A T A 

H • l 

DS* 

0 8 4 p 


RATA 

n • fV|P 

f T 

084Q 


DATA 

• 0 0 1 

DC UU 

0850 


DATA 

0 f /4 f 0 

DDF L, OF UN, DDLS 

0851 

* END 

OF nuPUT D 1 9 





KfHM I f 



( © 
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( 


r 


PAGE 0028 

11/03/77 10:04: 

27 9zj 500-10 RTV, Tf'X, CM MX H-HIA 

MACRO? (A?) 

SI= MACROS 80s 


Cl INF 

HaCRO 

0852 

* 




0853 


ENOC 



0854 

* INPUT (MATN) DIR 


0855 

* 




0856 

DIOIB 

SET 

& 


0857 

o:#3 

SF 1 

* 


0858 


CHAN 

x:: 

DIB CHAIN 

0859 


DATA 

DIC IB 

DC IB 

0860 


DATA 

0,0 

QUEUE, CM 

0861 


IFF 

P:EDX&FDX: 

0862 

D:IOSW 

SET 

D:IDSw; 

D:OOSR Ok INPUT 

0863 


ENDC 



0864 


DATA 

D:IDSW 

OSw 

0865 


DATA 

DtDVTP 

DT 

0866 


DATA 

•00’ 

DC UN 

0867 


data 

0,4,0 

DOE*., OF UN, DULS 

0868 

* END 

OF DIB 



0869 

* 




0870 

* DEVICE DRIVER LTB 


0871 

* 




087? 

DL IB 

SET 

$ 


0873 

l :*3 

SET 

s 


0874 


data 

0 

1 STNS 

0875 


DATA 

80FS: 

LSOFS 

0876 


DATA 

DEVADS 

LDADP 

0877 


DATA 

DtDFLG 

LDFLG 

0878 


DATA 

0 

LORTB*. 

0879 


DATA 

DiriB 

LICI8 

0880 


DATA 

one i b 

LOCIB 

0881 


DATA 

OBTRA 

LOBIR 

0882 


DATA 

0 

LTINT 

0883 


DATA 

0 

L01NT 

0884 


DATA 

0 

LISIN 

0885 


BAC 

TBUF 

LIBFS 

0886 


BAC 

EBUFF 

LTBFF 

0887 


BAC 

OBUF 

LOBF£ 


Tf S 


K OUTPUT !\SW 


FOR MOV 


m 
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PAGE 0029 11/01/77 10:04:27 94500-10 rtx, IPX, CO*X EPUAffS 

MACRO? Up) Sis MACROS 80= Ct. INF MACRO 


0888 

BAC 

o f 0 

l OPI.'F , t OHC 1 

0889 

DATA 

o, u 

LFCIb, IFRCTB 

0«90 

DATA 

0 

1 1 F UN 

0891 

OATA 

0 

l MOWS 

089? 

DATA 

P:i prm 

L L p A R M 

0893 

DATA 

t):sni v 

1 LSDLY 

0894 

RFS 

3#o 

i nnu.ni, ?, 5 

0895 

DATA 

P jPAi'S 

LOADS 

0896 

DATA 

0 

1 SPCH 

0897 

IFT 

n:f xip 


0898 

DATA 

0 

1EXCPT 

0899 

FXTW 

INTQS: 


0900 

SPAD 

Intos: 


0901 

JST 

Tmas: 


0902 

DATA 

$ f o § u f o 


0905 

DATA 

0 

TASK TO PROCESS TNT 

090 4 

DATA 

CTKPRl 

PRIORITY 

0905 

DATA 

0 

LFX ARC 

0906 

DATA 

L :*3 

x-»f f; 

0907 

DATA 

1 0 

P-RFG STORAGE ADDR 

0908 

I.OX 


I. IB ADDR TO X 

0909 

JMP 

*Dt T ft + LF XRT-N JUMP TO PROCESSOR 

0910 

RFS 

12# 0 

IN,OUT, CE MfPAL MASKS AND PROCESSOR 

091 1 

enoc 



091? 

* 



0913 

* END OF 118 



0914 

* 



0915 

* 



0916 

* END OF DFVTCF TAOIFS 

0917 

t-PODL 




0918 

* 




0919 

* ESCAPE MACROS 




09?0 

* 




0921 

HACK SET % 




092? 

DEVFIX . 

FIX 

UP 

DFVICE TNFO 

0923 

INTSET . 

SET 

HP 

INTERRUPT VECTORS 


O 


c 
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PAGF 0 0 50 11/05/77 lcti'a; 
‘■•APRO? (A?) SIS V.ACPMS -<(: = 

09 ?U 
09?S 
092.0 
0927 
092 * 

0929 

0910 

0931 


2 7 9/1 SO 0* 1 ii *7*, 

ci roc mac 


I FT 

PROTsTIY 

TTYF I V 

. F I 

FNOC 


IF T 

PRUT=RSC 

HSCK I X 

. F T 

EMDC 


RFL 

RACK 

FK'DR 



u* r r>tv> F 'v f. • A T f S 

-• n 

< UP TRlS FOP liy 

< UP T Hi $ FOP fisc 
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MACRO? (A2) SI= MACROS 80 = nu"v 


0933 

0930 

0935 


MACRO Cl. UN 

DATA #l + :00rt0 COMX STANDARD LON GENT WA T ION 
FNOH 


II/3-45 


O' 


PAGE 005a 11/05/77 1< 

MACRO? (A?) 81= MACROS 


0937 

0938 

0939 

0900 

0901 

0902 

09a3 

0900 

0905 

0906 

0907 

0908 

0909 

0950 

0951 

0952 

0953 

0950 

0955 

0956 

0957 

0958 

0959 

0960 

0961 

0962 

0963 

0960 

0965 

0966 

0967 

0968 

0969 

0970 

0971 

0972 


0 4:27 


r u s o r>. 


TO* , 


E UliAlES 


t'i: 


0F : VICF 

E APRn 




macro 

OF VICE 




np v: 

SET 

0 

I K‘ I T l A 1 

DEVICE 

ID 

LISE: 

SE T 

0 

INITIAL 

1. INF TD 

speed: 

SET 

0 

INITIAL 

SPF> |) 

(PAHD RATE) 

oevad : 

SE T 

0 

iht t r ai 

nr v !cf 

ADDRESS 

I ADD: 

SET 

0 

initial 

T*TFPP 

OPT ADDRESS 


parameters off 


DEV : 

SET 

01 + 0 


IF T 

#?> = ? 

LINE: 

SET 

ENDC 

02 


IFT 

«?>= 3 

SPEED: 

SET 

ENDC 

0 3 


IFT 

«?> = 0 

DEV AO: 

SET 

#0 + 0 

I ADD: 

SET 

FNDC 

#5 + 0 


IFT 

*?> 5 

k : 

SFT 

1 


PF P T 

#?-s 


SFTONF 

FNDC 

#6/ #7 


SOW START Op VICE OR TP NT FO GpN'FRAT T Dn 
SYNC MODEM CONTROLLER 


Tit SET 

T 2: SET 

SMC: SET 

TFT 

LJOICB SET 
LSOPCR SET 
DJDFLG SET 
D:F*JP SET 


DE V:=617 
f>Ev:=51 3 
T1 :; T ?: 

smc : 

ID T CIH 
LDOC Tb 
0 

1 


STANDARD LENGTH CTO 
STANDARD LENGTH CTM 
IDF LG WORD 
EXCEPT I NT DEVICE 



PA of 003 * 

n/"s/ /7 

1 u : 9 o : 

87 "OS 9-1 > S 

i. , i < , *, (. 

^ X F «Ji » ii n S 


w ACP0? (*?) 

Sir K A C8 n 

S nor 


i,f v i r 

1- *■ iC u i.l 



09 7 ^ 


i ■: s i) l y 

si- r 

? 

i II h f "l : 

T f mm t' ni: F ’ : } i ■-.■ a i 


0970 


ins* 

sf r 

: j n u 7 

i , S *• - f 1 r- 

r ?, wf a * > 


097* 


n : i n s a 

S8 1 

: /in ] '» 

, = R 

r. ^ ~ ] T f u 


09 7 b 


n • r ■ v i p 

5 F 1 

, Sf , 




0977 



f "Of. 





097* 



f Ml,* 1 





0 9 8 0 


+ 






098 1 


* 

Of V TCF 

F- j yi ip n 

ACPI ■ 



098? 

09*3 


* 

m^C ° i ' 

OF VF T v 

8 T X ! u- r-i 

V l c F / f ! f Cl TAJ 


09*0 

0988 


♦ 

TFT 

s Mr: 




f 98 h 


* sf r 

UP TNTF 

^ t* U t J T & 

D'-.PF :,Sr s 



09 8? 


* FXCFPTTOm 

f a T F i ; 

* r 


\ 

09*8 


* 





, T 

0 98 9 



n*>fi 

di.Th+i f 

* s r a, 


> - - 

0990 



X! 

s r.M ** 




0 991 



nPG 

I'Ll H ♦ 1 f 

X T s i‘ 



0 99? 



xo 

sc•FVx 




0 98 3 


* I r M 

Pl'l iMfMKllPIS 




0990 



09 a 

01C T M ♦ c 

ImT.Sk- 



0 99*- 



v D 

sc : tf x 




0 99 b 



r IPG 

j ■ 1 r i u * r 

PH 


j ■ 

0 99 7 



xn 

.SC : I f h 




0 99* * OUTPUT i M f F } <> <i£>T * 


0999 

0*r; 

i j H I H A + r I f ( s ► 


1 000 

X f; 

CO: OF * 


100 1 

P&f, 

f !H I P A +f iJiH J A; 


1 00? 

X J 

s r : j f h 


100 3 

* SF T SYNC 

OF T F f f t .) T /( f PT ] 

r j 

! 000 

OPf, 

m i ulsf vr h 


1005 

IF T 

PRO 1=HSC 


1006 

XO 

sc:osy 


1007 

EM)C 
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MACRD2 (A?) SI= MACRO*- -UJ = 


00500-10 RTX, TPX 

device macro 


coma Ff'UAres 


1 008 
1000 
1010 
1011 
101 ? 
1013 
1010 
1015 
1018 

1017 

1018 

1019 
! 0?0 
1021 
1022 
1023 

1020 

1025 

1026 

1027 

1028 

1029 
10 30 

1031 

1032 

1033 

1030 

1035 

1036 

1037 

1038 
10 39 
1000 
1 001 
1002 
1003 


- SHIFT DFVICE TO PROPER HIT POST T10* 

'i- 'vu: SFT OEVADJX3 SHIFT LFFT 3 Flip SMC 
ENDC 

’ -90 0 F SMC DEVICE OF.PENDENT SETUP 

T 

» TE VICE DEPENDENT xffr vector address 

ORG 01,I8+LDRT6L 
IFT DF.V:s513 

IFT PPOTsSSC 

IFT ASCII 

EX TP SC:8 A5 

DATA aSCjBAS 

FNDC 

IFT FBCOIC 

EXTR SCjHES 

DATA *SC:RE5 

ENDC 
ENDC 

IFF PROTsHSC 

XD SC:513 

ENDC 
ENDC 

IFT DFV J =617 

IFT PRO T =RSC 

IFT ASCIT 

EXTR SC :BA6 

DATA *SC:RA6 

ENDC 

IFT EHCDTC 

EXTR SC:BE6 

DATA *SC:RE6 

FNDC 
ENDC 
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MACPU? (A?) SI= MACROS BO = 


10 77 

1078 

1079 
1 080 
1 OR 1 
1082 
1083 

1080 

1085 

1086 

1087 

1088 
1 089 

1090 

1091 
109? 
1093 
1090 

1095 

1096 


9 0 5 0 0“ 1 0 RT*r 1UX, COMX FDIIATFS 

INTERRUPT VECTOR fsFT"P PAr.RO 

MACRO INTSFT SFT UP TNTFPRUP7 VIC TOPS 
* SFT UP INTERRUPT VECTOR 
I FT SMC: 

ABS I ADD: 

JST * Si + 1 

DATA OLlB+IPyCPT EXCEPTION TNT 
AIB DEVAD: INPUT BYTE 

DATA O r 0,0 

JST *$+} INPUT FOB 

DAT« dicih 

ADH OFVAD• OUTPUT BYTE 

DATA 0,0,0 

JST *$+l OUTPUT FOB 

DATA 08IRA 

PFl. DLTR + LTINT 

DATA I ADD: + ? TNPUT BYTF TNTFRRUPT ADOR 

ORG DLlB+lrtlNT 

DATA TADD:+8 OUTPUT BYU INTERRUPT ADDR 

ENDC 

FNDM 



O',-l / I I 


P *GF 0057 11/05/77 io:oa;?7 oasoo- 10 gj <( fax, r uni/nfs 

^ACPn? .(*?) ST= macWOS Hf)= | T-ft jn ftFluP MdfVf 


1 09ft 
1 099 
1 1 00 
1101 
1 10? 

I 1 05 

II o a 
1 10* 
1 1 Oft 
1 1 07 
1 1 Oft 

I 1 09 
! 1 1 0 
Mil 
111 ? 
1113 
nia 
in* 

II lft 
1117 
! 11 ft 
1119 

I 1?o 

II ? 1 
1 \?? 
1 1?3 

I 1 ?a 

II 25 
1 l?ft 
11?7 
1 1?H 
1 1?9 

1130 
1 131 


VAC‘ 3 0 - l I 

* 

* l I 9ft 1 ft F T if- ( vj ft Y M f U i (_ ft lit TKIftlH nf t J ' F = r. 

* fHFSf ftYMftnis iiSfO ( a T F K ft i>9 f n f; v F ‘ IF r, f 

* 

K: SFl ( 

SU M : SFT o 

FF^T <t~ r ( n > i~*• ss j k i h v/ i I r (■ n i ] rh 

SF MUX ; Jf 1 # ? # *>, & t S # * # 7 , 8 AIL FLSSl> ! ll v /' i I * F > f 

♦ 

★ f)£.'TFPMTr 4 F A m s * P \< ^firp 

* 

S w T T T H SFT L T ! F : > = S 

* 

* Cm! C K -V.Ai T r» i [ y up | F M f 

★ 

IIf 

NOTF F #•!,.! NF 8 H F f If I f A T J h n TLyA| 1 0 • 

£m)C 


* hrTFWMINF 

a 

1 iMf. omPl F > 

hov: SFT 

L ?; L n a 6 1 1 « 

FfiY: SFT 

* 

i i»;l i ;l 

* n F T F H M f iM f 

* 

8 Y N C HP ASY 

SYNC: SET 

i. 3 H a; i 7 ; i « 

ASYNC : SFT 
* 

L L ?! 1 ;i. ??l. s 

* * i F T F P *4 fft 

* 

LOI'P-P I)*-■ f i 

Mnnpn sf t 

FnDm 

L 0-1L 1 
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( 


PAGE 0038 1 1/03/77 10:00:27 9050()-10 Rfx, 10 V, cm** EQUATES 

M ACRO? (A?) SI= MACROS 80= MISCELLANEOUS SERVICE MACROS 


1133 
1 1 3 A| 
1135 
t 1 36 

1137 

1138 

1139 

i iao 
l toi 

1102 

1103 
1100 

1105 

1106 

1107 

1108 
1109 
1 150 

1151 

1152 

1153 
1150 
1 155 

1156 

1157 

1158 

1159 

1160 
1 161 
1162 
1163 
1160 
1165 


* 

* POSBIT MACRO - CREATES A VALUE IN PROPER HIT POSITION FROM 

* A IRDF/FALSf FLAG AND A MASK f-PHATE 

* CALLFO AS: 

* POSHIT FLAG,MASK,OPTIONAL-NE'w-SYMHOL 

* THE FLAG IS SMIFTFD IMP THE BIT POSITION SPtriFlEp y 

* MASK AND THEN IS EQUATED TO EITHER THF FIRST PARAMETER 

* SYMBOL OR The THIRD PARAMETER SYMBOL (IF SPECIFIED) 

* 

* EXAMPLE 

* POSBIT 1 , : 0000,MYEL Q 

* RFSUITS IN M Y F L G HE I NR ;,f I (KOI I QUA If t;) I 0 

* 

★FLAG SET 0 

* POSBIT FLAG,:S,LABEL 

* RESULTS TNLABFL BEING SET TO 0 

* 

★ FLAG SET 1 

★ POSBIT FLAG,:8000 

★ RESULTS IN FLAG BEING SET 10 J8000 


* 


*3 


31 


MACRO POSBIT POSITION FLAG BIT In KURD 

SHFCNT «2 CALCULATE SHIFT COUNT 

IFT *? = 3 SET NFW PFSULT IF 3 PARMS 

SET 31XSHECNI SHIFT VALUE TO PROPER POSITION 

ENDC 

TFT «?=2 

IFF SHFCNTsO SKIP IF NO SHIFTING 

SET »1*SHFCNT SHIFT VALUE TO PROPER POSITION 

ENDC 

ENDC 

ENDM 


* 


1167 


II/3-52 


PAGf 01H9 11/U5//7 10:oa:?7 9<»SiH.-pi u T v h x, | !* x > ?FS 

MACW02 (A?) SJs MACROS «(>= ’MfCH.I AMKU.iS SC RvTC c K A C. *v (s S 


1 166 

* 

S Y m m n i 

SF (OP Mj|( 

T I R(. F x op 

1 169 

★ 




1 170 


H AC ;> <' 

SF T Mi i < 


1171 

r l : 

SF I 

K: + 1 

ACf'i.iiN-T Flip PAHAMFlfW 7FPO 

117? 

l*T 1: 

sf r 

L I vF ; =»T 1 

: SET F AfH If Mli.ru fROf ..t- fm 

1 1 73 

SUM; 

sf r 

T 1 

; Si.im p r s ii | is 

1 1 7a 

K: 

SF T 

K: + l 


1 1 75 


F N!) M 




1 1 77 


MACRO 

SHF CM 

OF T f km 1 fvf 5H I F I cnu 1 } T o r * r /■ OK 

1 1 7 8 

SHFCNT 

SF. T 

|) 


1 1 79 

val : 

SF I 

# 1 

V AL 1 *F- OF 

1180 


RF RT 

1 M 


11*1 


SHF i j 

• 

C -l HO a T K. 50: I F r i.il'cr T 

1 IF? 


F Ni n m 




1 ISO 


m A c R U 

SHF 1 ; 


1 1 A5 


IFF 

v a t : x i = i 

•S *v 1 H If >' I r.P 1 Jii.S 1 1 F 1 F 

1 1«6 

v a i : 

SF T 

vAt -1 

S'UF I 

1 1 57 

SHF-TO T 

SET 

S H F f>j T + 1 

amp rroMi 

1 !«* 


F HOC 



1160 


f MOM 




1191 

* 


119? 

* 

THE SFlOK'F v AfRP SETS THE PROVIDE PAR A ME I f « 

1 193 

★ 

TO A (• ':i F A \ I > INCRFME MTS K J 

1 19a 

* 

THIS IS CSFn FOR SC'ANNIM; Of f P A R A m F ff P r - 

1 195 

* 


1 196 


M A C R 0 SElMHf 

1 1 07 

& k : 

SFT 1 

1 1 98 

w • 

• 

SE T k ; ♦ 1 

1199 


FNDM 

i?no 

* 
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( 



( 


PACK 0 04 0 11/05/// 1 0 : 0 4 : 2 7 9450 0- 10 4 T x , ]n>, ( ( .X f-: • t i A T (• s 

M A C R 0 2 (A?) STs MACROS ROs •* I SC f I I A MF (HJS SffRv'ICF ^ACPiS 


1201 

* 

ijHF XD 

macro 

OFCLARFS 

AM MTFRNM. DATA I T \ ” 

1202 

* 





120 3 


MACRO 

Xf) 



1204 


F X TR 

4 i 



1205 


DATA 

*1 



1 206 


F N 0 m 




1207 

if 





1208 

ic 

Hfc ADfc R 

macro 



1209 

* 





1210 


MACRO 

Hf ADfcR 



1211 

if 





1212 

HOP! CT 

SET 

« 1 + 0 

COUNT 

0F CHARS 

1215 

HQRSC1 

SET 

42 + 0 

CHAR 

1 

1214 

HDPsC? 

SET 

4 3 + 0 

CHAP 

? 

1215 

hoR : C 3 

SET 

44+0 

CHAR 

;< 

1216 

hop • C 4 

SET 

4 5+0 

CHAR 

a 

1217 

HD»: CS 

SFT 

b 5 + 0 

CHAP 

s 

1218 

HDR 2 C 6 

SET 

#7 + 0 

CHAR 

6 

1 219 

HOP: C 7 

SFT 

48+0 

CHAP 

7 

1220 

H o p : r 8 

SFT 

49 + 0 

CHAR 

8 

1221 

hop: CP 

SET 

4 10 + 0 

CHAR 

u 

1222 

HhP:C A 

SET 

s 1 1 + 0 

CHAR 

1 0 

1223 

* 





1 224 


ENDM 






p AGF 00/4 1 11/04/77 1 0: 04 :? 7 

M ACW f .V (A?) <5 T r macros Pf'ir 


^OSt’O- l <> 4 T x , I r y 

hst &h n i iX; a i 


i ( ♦ N X h { i U A I f 5 
r )F S ) KK* r f m; v.Af ^ >1 


1 2?0 


m a c " n 

1 227 

PRO I 

SFT 

1 ??P 

ASCI I 

SP T 

12 ?« 

FHCDIC 

SF T 

1 2 30 

*L ATF 

•SFT 

1 ?3 1 

XPPKiT 

SFT 

1 2 4 ? 

11 X P R N T 

SF T 

123 ^ 

"If 

SF T 

1 234 

si.Avr 

■SI T 

j? 3 s 

f>I SC DM 

sf r 

i ?36 

k : 

SF T 

123 7 


RPPT 

1 ? 7 M 


SFT 0 NF 

1239 


I P T 

! 24 0 


FiOTF 

! ?<4 1 


F a* DC 

1202 


TFT 

1?«3 


NHTF 

l?uu 


F;PJDC 

1 ? 4 S 


IFF 

1206 


NOTF 

120 7 


ewne 

i ?<ie 

p : ** a x I 

SFT 

1 ?UQ 

p : p a n s 

SF T 

1250 

Prices 

SF T 

l?Sl 

p : l C 18 

SF T 

’ ?s? 

P:MC T H 

SFT 

1 25 ? 

P : F i > x 

SET 

1250 

P: osw 

SFT 

1 255 

PjC.KSW 

sf r 

1250 

p:ov tp 

SFT 

1257 

p :cl sc 

SFT 

1251 * 

p: m x s 

SF T 

125 4 ? 


IF T 

1260 

P:i ppm 

SFT 

1261 

PrCr.FC 

SF. T 


m s r 
S f 

• ) 
o 
<» 

4 t 

0 

n 

n 

1 

«?-1 

f r' r $ * 0 tt U , ft S # £ 6 # £ 1 , ? S , Q , n ] (; 

asct i k, r ^rr> i r 

F » ' 0 0 T h ASCII i* <\ i • t HC" 1 c SHFC TF 11 ; ' 
% 0 0 M I K 11 x p R N( T 


F r 9 rM * T h 

1 PA^SPAht* f vT OPTIU^S CA K? T HP 

A 5 C lift h : f 

i i r r 

F , 9 HHSI 

s p f r i f y { i< a r; a n p u sf f ascii 

* 1 

: F f o h 

HSC. FAT? CFArAfTfWS 

0 

CPf i r,c flag wr-pii 

i PC I M 

IFLP1H f.F LIP 

i 

*•0 IF C ft S Pf i< PKf'l t T f»F 

n 

"ALP cilf'l P X PROTOCOL 

: S 0 F F 

f>SW - AI L (> * PF A 0 , ?. F 

1 

CHf CKSU" PP;' T<’Cl 'L F t AC 

1 H S 1 

>«, 

* ? S C 0 h I f C" A'• S 

0 

ASCII 

:P 

ASCII, 0-M T 7, FVr\ PA^liy 

: MO 7P 

C‘4F C*SJP FLAGS 
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"ACP02 (A2) SI = MACROS ROr 


9 4 5 0 0 - t n ° T X , TO*, CIO « M'jUATPS 

BSC PKOlnrm DESIGNATING MACRO 


126? 

P:ocm 

SFT 

0 

NO OUTPUT CHAR MODIFICATION 

1263 

P;SYNC 

SET 

: 16 

ASCI! SYNC CHAP 

1264 

P: L C S 

SET 

i 

LINT CHAR SET USASC1I 

3 265 

T 1: 

SET 

XPRNT - 1 


1266 

T 2 : 

SF T 

IIXPRNT = 1 


1267 


IFT 

T1 : ;T2: 

DO IF SONT FORM OF TRANSPARENT 

1266 

P:CKSP 

SET 

: aoo i 

CRC POtYNOMIAL - x** 16 + X* * 15 + /**?+1 

126R 


ENDS 



1270 


IFF 

T1 : JT2: 


1271 

PtCKSP 

SET 

: 0 060 

LRC POt YN0 m T A1 - V **8+1 

1272 


endc 



1273 


ENDC 



1274 


IFT 

FBCDIC 


1 27S 

P;LPRM 

SFT 

: ooc 

EBCDIC, b-BIT, NO PARTTY 

1 276 

PjCKFG 

SFT 

: 60F F 

CHECKSUM FLAGS 

1277 

P:CKSP 

SET 

: a o o i 

CRC POI YNOMTAI - X* * 1 6 + X * * 1 5 +X**?+ 1 

1276 

p;SYNC 

SET 

: 3? 

EBCDIC SYNC. CHARACTER 

1279 

P:ocm 

SET 

0 

OUTPUT CHAR MODIFTCAT TON 

1280 

P:lCS 

SET 

2 

LINE CHAR SET EBCDIC 

1281 


ENDC 



1282 

ULC 

SET 

ULC X 1 0 


1263 

XPRN7 

SFT 

XPPNT %R 


1 284 

IIXPRNT 

SFT 

lIXPRri f%8 


1285 

MASTER 

SET 

st AVE-nu 


1 286 

P:DFIG 

SET 

MASTFR+UXPRNT+XPRNT+ULC 

1287 


PNOM 




1289 

* 



1290 

if 

BSC FIXUP 

MACRO 

1291 

1292 

★ 

MACRO 

8SCFTX FIX UP BSC AFTER CLINE 

1293 

it 

SFT UP ORTVFP ENTRY ADDRESSES 

1294 


ORG 

PICIB+CJTBL 

1295 


XD 

BS:RPE 

1296 


XD 

BS:wPE 



PAGF 004 3 11/0*/7/ 10 • 0 4 S ? 7 

M AO'0? ( A?) s I = MACROS wn = 

i?*>7 i) 

!?9F x 

1 * SF T ti 

1*00 U 

1*01 I 

i *0/ n 

i S 0 * F 

130/t I 

1 309 [> 

!*C* F 

1*07 * SFT Ul 

1*0? t*i 

1*09 Ti 

1 * In 11 

1*11 Xi 

1*1? FI 

1*13 11 

1310 X' 

131S fi 

1 31<S F ! 

1317 Tl 

1310 xi 

1319 F' 

1 3?0 * SFT III 

1 3? 1 II 

!*?? TI 

13? 3 Oi 

13?4 Xi 

1 3? 1 * X! 

13?6 Fi 

I 3? 7 * St. T III 

1 3?H II 

13?° Oi 

1 330 XI 

1331 XI 

133? F.i 


9aS(Mj- l (' W TX , 1 f > , ( i:.‘ 


F • iI/* If 



m sr - p p ij t• m (*i op 

DATA 


Xf> 

f« s * p r 

T ?•;pi! T (/-itm flNr* 

0*0 

pic p + tci*- 1 ~ +1 

TFT 

LSI * os 

DATA 

! ? 0 0 luSFfS 

r r fj L 

T 

L S I c 

[ > A T A 

1 0 t 1 t) i ii r F 1 S 

FM)t 


IIP PI?OTi:('.nL *• A S T F * TA-II 

UPG 

p T C T h + f; P t m | 

IF T 

A 5 C ! I 

!P I 

'-'t : v : =S 1 ^; * o v : = ^ * / 

X P 

w T : sr* a 

FMDC 


IFF 

ofv:=si3;DFV:=M7 

xn 

f- T: A SC 

f\D r 


f* Nor 


TFT 

F ^ r. STL 

Xi) 

fi T: F > i. 

FN or 


I IP A SC 

IT 1 PANSI ATI 1 Aoi.F 

IF T 

* L A T t 

7F J 

AS(.?! 

owe; 

p i o f D+ni xi i k 

yn 

ro: API 

xn 

cn j i pa 

FDD (. 


IIP F HC 

DID I •- a* SI. A Tf TO* 1 ! 

IFT 

F bt'D] ( 

OPl, 

PIDTi'.PMXI TK 

xn 

r d j f ? i 

xn 

CDST?F 

F HOC 
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PAGE 00^4 

ll/OS/77 l o: o«: 

27 94S00-10 RTX, inx, FOMX E.OUATFS 

MACR02 (A2) 

Sis MACROS RO= 


MSC PROTOCOL DFSIGUATJkG MACRO 

1333 


ENDC 


1334 

* SFT 

UP BCC 

GENERATOR 

1 33S 


0»G 

PIOIB+DCKSR 

1336 


xo 

CD:CKS 

1 337 

* SFT 

UP BLOCK SIZE PTK t TNE SPEED 

1 33ft 


ORG 

PIDIP + DBl KS 

1339 

T3 : 

SFT 

SPFED: /ft 

1340 


I FT 

T3:<P:maxt 

1341 


DATA 

T3: 

1342 


FNDC 


1343 


END* 



1 ) b h 11 3 tf >• - 1 s ( c *) cf ti'i D V a 

o:oi L !/'>.')/tl -ma 


ComputerAutomation 



^ r-- jc o e <\ K 1 t 

9 9 3 IT iT lf> J" 

l/; f/i K) Ki ^ fy> fsT) 
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P A 0. t 0 0/16 11/03/7/ 1 1 ): 0 u ; p 7 
m A C R 0 2 (A?) SF= MACROS fi O = 


1 356 
1 357 
1 358 
1 359 
1 360 
1 361 


p t x, ](>x, n^’t f r 11 a n s 

7 A ;; k ( i > *■: ] u n | 

MACRO BEGIN BEDIM TASK 

FXTP w FGTn: BFGfN TASK 

JS 1 KFtJlM! 

P A P A MS HF R 1 ’■) f & ? t 2 t 2 rHF C K M IMBf P OF P A P A NE T ( 
PTx:i "If*? data task adr,prioritv 

F NO v 


1363 
1 364 
1365 
1 366 


MACRO PAIJSF 
EX TR PAUSE : 

JS T PAUSE: 

ENOM 


allow POUND robin 
ALLO* POUND ROHJN 
CALL PTx TO ALLOW ROOM; robin 


1368 

1369 

1370 

1371 


PACPO TERM TERMINATE task 

£ X T» END: TERMINATE T A S* 

JS T F N f) • 

FNDM 


1373 

1374 
1 375 
1376 


macro abort 

EXTR ABORT: 
J S T Aft 0 R T : 
END* 


ABORT A TASK 
ABORT A TASK 


II/3-60 
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MACRO? (A?) Sis MACROS 

RO = 

P R 

137* 

MACRO 

GETPR 

1379 

EXTR 

GETPR: 

| 1380 

JST 

GETPR: 

i 1381 

ENOM 


1383 

MACRO 

SFTPR 

1380 

EXTR 

Sf TPP: 

1385 

JST 

SETPR: 

; 1386 

ENDM 


f 1388 

MACRO 

INC PR 

* 1389 

EXTR 

INCPR: 

\ 1390 

JST 

Incpw: 

1391 

ENOM 


! 1393 

i 

MACRO 

DECPR 

1394 

EXTR 

OECPR: 

1395 

JST 

OECPR: 

1396 

ENOM 



PTX, mx, COMX EQUATES 
IURTTY C 0 N T R 0 J 

GET CURRENT PRIOR]FY 
GF-T CURRENT PRIORITY 


ALTER CURRENT PRIORI TV 
ALTER CURRENT PRIORITY 


INCIM5MENT CURRENT PRIORITY 

Increment current priority 


DECREMENT CURRENT PRIORITY 
DECREMENT CURRENT PRIORITY 


<• © 
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( 



PAf,f 0 048 11/05/7 7 10:O4:?7 9qS00-to R 

MACRO? (A?) si= MACROS P0 = INTFR 


1596 

MACRO 

GET 

1 599 

F * T w 

GET : 

iaoo 

JST 

Gf T : 

100 1 

p A R A M S 

GFT 9 #? f 

100? 

OAT A 

n 1 

100 5 

FNDM 


100S 

MACRO 

PUT 

1006 

EXTR 

put: 

1 a07 

JST 

PUT: 

l ao« 

PARAMS 

p»-t ,*?, 

1 a09 

DATA 

* 1 

1410 

FND M 



( 

_I 


x , T [X» Cu v -x *-QOA TF S 
TASK COMMON [f; & r TO* 

GFT RFC.IST.tRS 
GFT RFGTSTPPS 

, 1 


PUT REGISTERS 
PUT RFGTSTEPS 

, 1 



I f / W>2 


PAGF oouv 1 1 /0 S / / 7 t o : 0U.:?7 w| 

MAC^n? (.A?) Sir HOr r >; t 


m ? 


TITS v 

-i ai 3 

f X T » 

i • r s v : 

i ai a 

JST 

T v r S v : 

14is 

PAPAmc- 

f usv, ft? 

1416 

D A T A 

*« t 

m? 

F Nif.)M 


1419 

MAC H« 

F N T 9 c; 

1*20 

f x T ^ 

D.!«S: 

1421 

JST 

I Ai T 9 4 : 

1 4?2 

F N 0 - 


1424 

HAG 911 

t n r a f 

1 u?s 

e x t iv 

T f, 1 A c : 

1 «?6 

js r 

t n j a c : 

1427 

p A K A N< s 

1G TAG » ft? 

14 28 

ptx : i 

* 1 ,#? 

1429 

FNOm 


1431 

m ACP-t) 

J K! T fJ 

1 4 32 

F X T9 

! N'T u : 

143 3 

JST 

1 n i 9 : 

1434 

FARADS 

T M w , 4 ? , 

14 3S 

DATA 

3,0, , 0 

14 3b 

htx : 1 

42,6 3 

1437 

TFT 

ft ? r 3 

14 34 

0 A T A 

0,0 

1439 

F NDC 


14 4 0 

I FT 

ft ? s 4 

1441 

DATA 

6 4 , 0 

1442 

F HiG 


1 443 

IF T 

«? = S 

1444 

DATA 

ft 4 , ft S 

144S 

F NDC 


1446 

DATA 

6 1 

1447 

F *■! r> m 




* r j f; * , C nn * ^iiiA-ns 
^ * f M r t r » .* { k | j 

S A V f P P V ? ( j . ; m £ * * | ( { - [ y W {if } ) 

c A V P F nv ] J- fr m n T { } j r ■ ; t i ) 

9 1 # 1 

0 a T /. ★ u P J t; i u> .\j An;1 J~ l- s C 


^ F V.) T r '• F f f M V }P f ? V ^ \ k 1 f j •• i n *•> 1 ) 
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A r T i V A 1 { r T A 3 * f J V { Y i ■ w f! n T ) 

A C f T V £ f F j A (1 T ► P - | :> i I 

f) A T A t A S K A f>n , pp j fjtv j j y 


G‘iE PF I A Sk ( l Ki p Wh j ) ) 

0n c 1 ! F I A SK f T f F .vf -1 Ii>l ) 

'^S 

T n .N p f F IIS X n P THUN; A \ i;4 S s 

!» a T a T a n k a | .* n , n n t i i-p t i y 

M? : A (.P X PH., fSTF PS 


A P F f ] s T ►- * i i hi i f 


A y , F.f f; j s T FhS 
&F TFFN A [ y l ‘>n \ SS 
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pack fH'SO l 1 /(('</ / 7 io:0'4:?7 PaS'^-ju 

MAf.pn? u?) si= >- ACM.s h()= |ii(- 


1449 


M a c ? n 

I 0 m 

1 450 

* 



1 451 

* 

GFNFPaTE I(»« 

1 45? 

* 



145 3 


Pf- S 

, 0 

1454 


D 4 T A 

i* ] + 0 

1455 


DATA 

9 1 

1456 

IQ R m : 1 

SE T 

#s+o 

1457 


DATA 

tax? 

1458 


DATA 

n 51 o 

1 4SQ 


OATS 


1460 


DATA 

0 

1461 


DATA 

# t> ♦ 0 

1 462 


END* 



K r x , 1 f x , rT;f■ X Hil Mt 8 

(;p .\ K P a T ; (P v A (, pi, 

t i! M, HI if K K p,i. km, T M, nPfPA | f On, mop. 1 i , i- 


OORDINAT TOO Ml, IK 4 11 Y 
I ON 

o 01.) T F T f P , IP AMY 
IOHMj l OPCDI'K * M 0DIFFER 
LKNCTH 
MUFFFP 

Aril.’A | COUNT 

OIRFTT ACCESS ADdPFSS, IK ANY 


A f l : ‘ | ) Ft * 
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PARE 0051 
MACR02 (A?) 


11/0 3/7 7 10:00:27 

31= MACROS RO= 


94500-10 »TX, 1 0 > , f tiMX FQUATE S 

S i! H ROUT IN F.; S FTC. 


1 060 


M A C p 0 

t-NT 

OFF INF SUBROUTINE 

1 065 

RTXtT 

SFT 

% 

DEFINF LOCATION OF RETURN uDORlSS 

1066 


STOP 

:3C 

:3C3C IS BLAG F f)R NOT C A l LEO VET 

1067 

surx: s 

SET 

0 

OFF INF RTN AS EX T T T YPE 

1068 


FNDM 



1070 


MACRO 

RETURN 

RETURN from last DEFlNtD SURRflOT f 

1071 


1FT 

SURX : : 


1072 


J*P 

RTXjT-l 

IF SURX IS EXIT TYPE 

1073 


ENOC 



1070 


IFF 

SUBX:: 


1075 


RTN 

RT x: T 

IE PTN IS EXIT TYRE 

1076 


ENDC 



1077 


FNDM 



1079 


MACRO 

ARC 


1080 


LD# 1 

*RTX:T 


1 0 A1 


IMS 

PTXjT 


1082 


FNDM 



1080 


MACRO 

COMSUR 

define- COMMON subroutine 

1085 


SPACF 

1 


1086 


FXTR 

suhx : 

EXIT FROM COMMON SUBROUTINE 

1087 


JST 

SURX: 

CALL SUBX TO RETURN 

1088 


ENT 


DEFINE ENTRY fc RETURN ADDRESS 1. DC 

1089 

subx: : 

SFT 

1 

DEFTNF SUBX AS FXTT TYPF 

1090 


SPACE 

1 


1091 


E N0M 



1093 


MACRO 

PROSUR 

OFF INF PROTECTED SURR0U1INE 

1090 


SPACE 

1 


1095 


FXTR 

Surx : 

EXIT from COMMON SUBROUTINF 

1096 


EXTR 

PROT : 


1097 


SPAD 

PPOT: 


1098 


JST 

SUBX: 

CALL SURX TO RETURN 

1099 


ENT 


DFFINF RETURN ADDRESS LOCATION 
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MACRO? (A?) SI= MACROS HO- S U 


1500 

a 1 

HI T 


1 SO 1 

siirx: : 

SET 

1 

! 50? 


JST 

PROT • 

150 7 


DATA 

at-1 

1 SOB 


SPACF 

1 

1505 


END* 


1507 


MACRO 

LOCSUM 

1508 


EYTR 

LOCK: 

1509 


SPAD 

LOCK : 

1510 


SPACE 

1 

1511 

#1 

HI T 


151? 


JST 

LOCK: 

1513 


DATA 

n? 

1510 


ENT 


1515 


SPACF 

1 

1516 


F NO* 


1518 


MACRO 

CALCOM 

1519 


FXTR 

SUBR: 

1 5?0 


JST 

SUBR : 

15? 1 

CNT: 

SET 

1 

152? 


RfP f 

a? 

1523 


SIX;? 

*1 ,n? f n 

15?a 


F NDM 


t 526 


MACRO 

CAL PRO 

1527 


JST 

#1 

1528 

CM: 

SE7 

1 

15?9 


PFPT 

*?- 1 

1530 


RTX :? 

n?,US,n 

1531 


ENDM 


1533 


MACRO 

CAI OCK 

1530 


JST 

» 1 

1535 

CNT: 

SF T 

1 


7 X I OX / F Ol'At I- S 

<> 0 (i T IN F S FTC. 

DEFINE FMfRY P(.)lNf 

OFF INF S U B X AS FXTT T YPF. 

CALI PRO7 

use R F T IJ RN LOC AS LOORi;INA I I00 a 


OFF INF I. 0 C K F 0 SUHROUTINF 


OFF IMF ENTRY POINT 
CALt LOCK 

COORDINATION NUMBER 

OFFImF RETURN ADDRESS LOCATION 


CALL COMMON SUBROUTINE 
CAIL COMMON SUBROUTINE' 
CALI SUOR 


SfUiX, </5, Vb, 07, nh, *>9, U 1 n, tt 11 , * 1 r> t A, a 1 


CALL PROTECTED SUBROUTINE 


, AS, *6, #1, bt‘, f #9, * 1 ft, n 1 ] , it 1 ?, f M, *,■ i n, j s 


CAIL LUCKED SURRU'.iTlOF 
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PAGF 0OS4 n/«I?//7 10 : 00 ; 

*ACPD P (4?) ,ST= MACROS H<l = 

15 36 
15.37 
1536 

1540 

1541 
lS4p 
154? 


21 O/jHOU-1 '1 ''I*, F o v , ro»--x 

i t 1 * i s h rr. 

KEPT *v-i 

P 1 X 5 2 a 2 r 4 X t •• m t a 5 t c K , t J t h, t a u , t- | u , 3 j 
F N i) M 


MACRO St 11/ 

F x F P S 1 1 14 X : 

JST SUHXr 

E *!!! •* 


f X J 7 Y H I M r f 1 M *•; (' Nj i i fV p f 
F X 1 7 Y Wf IP f i Sill Pi 


/ c 1 f f ~ 1 ' / 


Diinii 
1 T I “ r. 


1545 

1546 

1547 
154 6 
154 0 

1554 

1551 


MACRO LOCH. 

Exih lock: 
SPao lock: 
J s t l o r k : 


Ivu'K a f A f 11 7 iv 


f All t oo 


PaPah 5 LOO*##?,1,1 

0 A T A tt 1 , 0 ■ 10 k 1 < T aj A T f n rv t ,< 

E NOM 


E n - ; i j 


1553 

1554 

1555 

1556 

1557 

1558 


macro uni or k unloch a pack ity 

ex TP UN|,k : MNI. f'fK A pacti or 

.IS T UU| K : 

P AR AMS UNL0cK,a ?, 1, 1 

DATA * 1 

E OOP 


1560 

1561 
156? 
1563 
1 564 
1565 


MACRO ;! 0 Y- p Cl 7 ip -Oku I o. f A FAC T I f 1 r 
E x I p UNPR* t'f-PPi'Tf ( 7 A F A f TI T7Y 

,js r 1 ir .'hp • 

PAR A hs 1 inpRi'i | , 1 , | 

DATA n 1 

F M 1 ' m 


1567 
1566 
1 569 

1570 

1571 


MACRO PHOT P’>vf:7Ff7 A F AC 11.7 I v 

FX|P H P 11 7 j Pot) FECI a EAT 111 TV 

SOAP PHOT; 

JST PPuF: 

PAWAMS PPUT,*?, 1 , 1 
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MACPO? (A?) Sis MACkOS M 0= S n k w n <i J J u t $ FI 


ComputefAuto ma tion 


m 


L- 


tl 


«a T 

C> 

< z 

Cl LU 


ru ro 
r*^ r^ 
tn ir» 
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PAGE 0055 

1 1 / 0 3 / 7 / 

10:08*27 Vo 

8 n 0 -_1 0 Vli, IKX , cro-x F “i.<4 IF 

MACRO? (A?) 

8 I = * A C R fi J 

5 f< j f X 

'' »- i a r 

1575 


M f {. 1 1 

OFT A X 

157* 


b * [ * 

OP 1 AY: or [_ fl y F i >■ 8Pf » I F f! 

1577 


js r 

OF LAV: 

1578 


P A R ft M S 

r ' F l AY,*?, 1,2 

1579 


I F T 

a 1 < 0 

1580 


Mn TO 

x , NtN A T T V F .OF 1 A Y . 11 1 FGAl 

1581 


t o or 


1 588 


If- T 

« 1 II! 

1 885 


N 0 T f 

< , /F Oh.O f L A Y.1i 1 FGAL 

1588 


F NDC 


1 585 


IF T 

a \ > >, ? / (s 7 

1566 


NO T L 

X , I 1 -F . TOO.LAF OF 

1 587 


fc'NOr 


1588 


I F I 

*? = 1 

1 S 8 Q 


r; 4 1 a 

£; 1 , f 

1590 


ENOC 


1591 


IFT 

»? = ? 

1592 


DATA 

•7 1,8 ? 

1593 


o Mi>r; 


1 5Q'I 


0 Oflv 
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MACR02 (A?) 

1596 

1597 

1598 

1599 

1600 
1601 
1602 
1603 
160a 

1605 

1606 

1607 

1608 

1610 

1611 

1612 

1613 

1615 

1616 

161 7 
16)8 

1619 

1620 

162 t 
1622 

1623 

1 624 

1625 

1626 
1627 


11/03 /7 7 1 0*00:27 9 a 5 0 0 - 1 ('• R-fy, TOY, COM* f- (JU A'T f $ 

SI- MACROS P0= TnTERNAI MACROS 


MACRO 

PARAMS 

IFT 

«2<« 3 

IFT 

«3=1 

MOTF 

X,*1.NEEDS. 

FMDC 


IFF 

*3= 1 

NO TF 

X,*l.NEEDS. 

ENDC 


FNOC 


IFT 

n > a a 

NOTE 

w,M.USES.O 

ENDC. 


ENDM 


MACRO 

RTX : ? TO 

DATA 

*Cnt : 

SFT 

C N T : + 1 

ENOM 


MACRO 

R T x * 1 

DATA 

n\ 

IFT 

»2< 0 

MO TF 

w,PR I OR TTY. 

DATA 

0 

FA'DC 


IFT 

A2>819 T 

NOTE 

PRIORITY . 

DATA 

8 0 0 0 

ENDC 


IFT 

0<=#2<=81°1 

IFT 

a2>8000 

NOTE 

WrPRU'RTT Y. 





00*7 11 /(M/7 7 1 o : o m ? ] 
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C 
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MAC PC)? (A?) Sis MAC R 0 S P.flr 


9/lSi.i1 h I / , Jl' X, 
* A ( ' f. I’ »' 


F GO A r t S 


1641 



M ACPO 

Lit 


1642 



TFF 

LS1305 

1 

164 3 



ILL:: 

: 1 MO,Bi¬ 

1 

1644 



F.MDC 



1645 



JE 1 

ts M 0 5 


1646 



REPT 

* 1 


1647 



ILL: 



1648 



ENOC 



1649 



F N 0 4/1 



1651 



MACRti 

ILL: 


1652 



01 V 

1 


1653 



EL A 

1 


1654 



FKiDM 



1655 

00 10 


EOR“ 

III ::, 12 

,4 

1656 



macro 

I M T S T F 

C T f > I RTF ERUPT & OF VICE A DDHESS STUFF 

1657 



SPACE 

1 


1658 


DA 

FOll 

«1 

DEE T N f DE VICE ADDRESS * 

165° 


TNTAD 

FOOl 

"2 

DEFINE INTERRUPT ADDRESS (DATA) 

1 660 



APS 

I NT AD 

0 P C, T 0 A U T 0 I/O L (? C A T I 0 N 

1661 



DATA 

0,0,0 


1662 



APS 

T N1 A D+n 

OWC TD F MD — OF —Hi OF ¥ INTERRUPT 

1663 



JST 

* i. + 1 

GO TO CIO FOR 

1664 



DATA 

C IH 

. E ND OF CLOCK 

1665 



RKL 

0 

ORG TD RELATIVE /I ED (0) 

1666 



SPACE 

1 


1 b67 



END M 



1664 



MACRO 

STMT 

DEFER A IF CALL TO SETUP INTERRUPTS 

1670 



JST 

STMT: 

CAM SIKjKDMTINE 

1671 



IFF 

FI (SI 


1672 



DATA 

: 3600 

MAKFS STOP 

1673 



NOTE 

U,FIRST. 

PARA*EIE K 

1674 



EMTC 



1675 



IFF 



1676 



IFF 

*2 101 






HAGt- 0059 11/03/77 ] O ; (; 0:2/ 

«ACon2 (a^) st= ►'AC^ns ><0= 


9o50o- t n i T X , 
" a r 


1 ''*, c 

s 


i v x k*. "/ r *• 


1*77 

16 78 
1 6 7 f > 
! * ft 0 
1681 
1 6 82 
I** 1 * * * * * 7 ; 
i *ft a 
1 6ft S 
1 686 
1687 
1 foftft 
1 6ft 9 
16 6 0 
1 60 1 

1 692 
L 693 
1690 
1695 
! 696 
I 697 

I 699 

17 0 0 

I 701 
i 702 
703 
7 00 

705 

706 

70 7 

7 0ft 

709 

710 

71 1 


C I 9 
C :«1 


DA ? a 

: ;miH) 

K.n I ft 

ft 1 , st- no-;) 

f M-( 


M'DC 


T ft 1 

LS(305 

TFT 

ft 2 m 

D A T A 

H 3+ ! -i Oft 9 

»; NOT 


IF T 

ft 2 Dll 

DATA 

#3*160F 9 

ft N D C 


ft mop 


I FF 

ISM 0 S 

1 ft T 

#2 111 

!) A T A 

ft 31: 1 3ft 9 

ft NOT, 


Ift T 

»2 IDI 

DATA 

» 3ft: 2 3F o 

ft; N D f. 


ft dot; 


ft M1M 


M AC91 i 

t M 

TT Tl. 

* *-• f x / 1; x 

TTT|_ 

r:#i...n 

DAM 

C:»1 

F x T 9 

Mm; , I r T t 

X Oft ft 

ftO 

xhff 

ft 5 

XOEF 

ft 6 

I A; T S f F 

* 2 , : ft 3 

ton 

% 

DATA 

Sf.H; 

IFT 

LSI 305 

SFA 

DA VI + 1 


( haa i Tf- ^ i /') r 1 ■■i- 

•D Tkf’l l 1 ft . I !• f HkM A T J • i 


( 
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RAGE 00 h 0 ll/os/77 10:00:27 R/i60u-ip 0 T v , ]'•>, ( ; * f < m ; o ns 


macR02 (a?) 

61= macros ro= 


m a c '■ ■' 6 

1713 


IFF 

I S I 3‘>S 

171 a 


SFL 

i > A % 1 ♦ 1 

1 7 1 S 


FO-DC 


1 716 


,1 a T 

1 fj T .j: 

1717 


0 A T A 

* , ft, o , o, i NTR!, 6 1 hv, 0, C : VI , r■: a i , o, o , o 

171* 


XRFF 

a n 

171° 


XPFF 

a 0 

1720 


l>A T 4 

0 

1721 


XREE 

n b 

1722 


DATA 

0 

1723 


l LA 

« 7 

1 72a 


n A T A 

TNT AO 

1725 


RFS 

12,0 

1726 


DATA 

3+1,1,3+ 1,0 

1 727 


END 


1726 


t NDM 


1729 


MACRO 

OIr 

1730 


TITL 

'hTX/IOX CHA F A C TFk I/O DRIVERS 93302-1XE" 

1731 


T TTL 

0:*1_DE V TCF.TNF0RMAT1ON.HLOCK 

1732 


NAM 

0: M 

1733 


F X T R 

C: * 3 

17 3a 

d:*»1 

CHAM 

x :: 

1735 


DA T 4 

C : * 3,0,0, : s a 

1736 


TFX1 

F2 

17 37 


data 

o, :»s, ia6, («, :«7 

1736 


END 


1739 


ENOM 


1 7a o 


MACRO 

XDFF 

1 7a i 


IFF 

a l 101 

1 702 


F / T R 

I: a 1 

1 703 


E N D C 


17aa 


fndm 


1705 


MACRO 

xRf F 

1706 


IFF 

a 1 1 0 1 

1 70 7 


DAI A 

1 :*t 

1706 


FNDC 
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OOO 1 

0 R / 0 1 / 1 b 

u 9 : a 7 : 3 7 

MACROS 

( A 2 1 

SI= CURDS 

H() = 

0125 



* 

0126 



****** 

0 1 ? 7 



* 

0 1 ? M 

0 o 0 0 


NAM 

0129 



EX [ R 

0 130 



★ 

0131 



* * * * * * 

0 13 2 



★ 

0133 

0 0 0 0 


0: 1 YOU CHAN 

01 30 

0 0 0 1 

0 0 0 0 

DATA 


0 00? 

0 0 0 0 



0 0 0 3 

0 0 0 0 



0 0 00 

5066 



U0 05 

DUDR 



0006 

80 H 0 


01 35 

O007 

020C 

DATA 


0008 

0 AGE 



00 0 0 

060 0 



00 0 A 

0 000 


0136 



END 

0000 

ERRORS 


0000 

warning 



RTX/lOX CHARACTER I/O DRIVFRS 9330P-1XE0 
!) : T r 0 0 - TELETYPE CONSOLE 


******************** 

0: T Y 0 0 

c: l y o 

******************** 

x:: 

t:!YO, 0 , 0 , : 50 66 * ' rY', ' 00 ' 


?oC,:A6 E,:oboo f o 





x nooo c:r xo oi2v o 1 3a 

n 013? utiroo oi 2 h 

u 0000 x :: 0133 
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X 
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'V 
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c- 


ui 

X 

kXJ 

> 


LJ 

< 

rv 

< 

X 

LJ 


X 


y 
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PA6E 1)001 09/01/7b 09:47:37 

MACK02 (A?) SI= CH9DS H!) = 


hMX/IOX CHAkAC 11H 1/0 L> R I V E K S 95302-1XE0 

c : t y o — 7 el e. type 


0251 0000 

0252 

0253 


NAM CJlYO 

E x T R 1 n T Q : , I n l P: f j : u F. a o , I : RI T E , I : M in 

Ext k sen: 


0250 0002 

0254+ 0002 0000 
0254+ 0003 0000 
0254+ 0004 0000 
0254+ 0006 

0254+ 0006 F 9 0 7 0007 
0254+ 0007 0000 
0254+ 0000 


1 N r S T F 7 , 2 


0255 
025b 
0 25 7 
0258 
0259 
0263 
0264 


0265 

0266 


0267 

0268 



000 0 

c: T YO 

F DU 

i 

0000 

0 00 0 

CIB 

DATA 

SCh : 


0 00 0 


IFF 

LSI 305 

000 1 

403F 


SEL 

DA,7 SELECT-FC = 7 




ENDC 


0 0 0 2 

F 9 0 0 0 0 00 


JST 

INI Q: 

0 0 0 3 

0 0 0 3 


DATA 

*,0,0,0,INTP:,6160,0,CIB,CIB 

0 o o n 

000 0 




0 0 05 

0 0 0 0 




0 0 06 

0 0 0 0 




0 0 0 7 

OO0O 




0 0 0 6 

1 F F 4 




0 009 

0 0 0 0 




0 0 0 A 

0 0 0 0 




0006 

oo oo 




oooc 

0 0 0 0 


PtS 

3,0 

0 0 OF 

(>000 


DATA 

I :head, I:pite, o,l: fun, o 

OO 1 0 

oooo 




00 1 1 

0 0 0 0 




001? 

0 0 0 0 




0 (11 3 

oooo 




00 14 

1 353 


LLA 

4 

0015 

0002 


DA [ A 

IN I Ai> 
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PAGE 
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09/01/76 

09:a l :37 

macro? 

(A?) 

SI= C HR 1)3 

HO = 

0269 

00 16 

0 0 0 0 

RES 

0270 

002? 

0023 

DATA 


0023 

0 0 01 



0020 

0 0 ? 5 



0025 

0 000 


027 1 



END 

00 00 

ERRORS 


oooo 

*ARN1NG 



m 


m 


KTX/lUX CHARAC1E& 1/U DRIVERS 93302-1XE0 
C : T Y 0 --- lELETYPE 

12,0 

S +1 , 1,«+1»0 




n>w> S' H -) A I H (i M/l .d310VHVMD Xi)l/XJH W/10/60 tt'OO ^‘IVd 





OH—V./ I 


PAGE 0001 09/01/76 09:47:37 RTX/TOX CHARACTER I/O DRIVERS 93302-lXfct) 

HACH02 (A2) Sl= CHRDS BU = CHARACTER READ-WRI IE PROCEDURES 


0427 

0 0 00 



MACH 


0 

MUST WORK ON LSI ANI> ALPHA /NM-16 

0428 

* 

* 

if 

* * * 

★ 

if * it if 

*************** 

* * 

0429 

* 








0430 

★ 



ORIGINATING NAMES 


0431 

* 








0432 

* 

* 

if 

if * k 

if 

* * * * 

*************** 

* * 

0433 

* 








0434 

0 0 0 0 



NAM 


I: R E a d 

INPUT REDOESi 


0 9 38 

no m 



NAM 


I : R I T E 

OtJlPof RE UUP SI 


0436 

0 0B5 



NAM 


i :KIJN 

SPECIAL eunciiuns processor 


0437 

0083 



NAM 


R I I E2 

OUTPUT End OR RECORD (CR,LF, 

ETC) 

0438 

* 

if 

if 

* * * 

if 

* if if if 

*************** 

* * 

0 4 39 

* 








0440 

* 



EXTERNAL NAMES 



044 1 

★ 








0 4 4 2 

* 

if 

* 

* * * 

* 

* * * * 

*************** 

* * 

0443 

* 








0444 




EX1R 


hegin: 

BEGIN Iask SERVICE 


0 4 4 5 




e XTR 


End: 

END TASK SERVICE 


0446 




EXTH 


SUHR : 

BEGIN COMmun SUBROUIlNt 


0 4 4 1 




E XTR 


sohx : 

END COMMON SUBROUTI HE 


0448 




EX IR 


DELAY : 

delay service ROUTINE 


04 4 9 




EXTR 


EOF : 

ENO OE EILE TASK 


0 4 S 0 




tXTR 


E OR: 

END OF RECORD TASK 


0451 




EXTR 


EORS r: 

SET STAfOS AND END OF RECORD 


0452 




EXTR 


s in r: 

SET IN IE HURTS TASK 


0453 




EXTR 


S 10: 

START I/O 


0454 




EXTR 


Cksom: 

COMPUTE CHECKSUM IASK 


0455 




EXTR 


FE TCH: 

GET CHARACTER 


0456 




EXTR 


EOECK : 

CHECK EUR END-UF-FILE 


0457 




EXTR 


HUE FO : 

PUT BYTE INTO BUFFER 


0458 




EXTR 


WAIT: 

WAIT EUR DEVICE 


0459 




EXTR 


FOE u: 

CHECK EUR ASCII EOF ('/*') 






II/3-81 




IT/3-82 


PAGE 

MACHO? 

0497 
0496 
0499 
0500 
0 50 0 + 
050 1 
050? 
050 5 

0504 

0506 

0509 

0510 

0511 

0511 + 

0512 

0515 

0514 

0515 

0516 

051 7 

0516 

0519 

0520 

0521 

0522 

0525 

0524 

0525 

052b 

0527 

0528 


‘■O 




0003 09/01/76 09:47:37 

(A2J Sl= CH.HDS BUr 


RIX/1UX CHARACTEH I/O DRIVERS 93302-1XE0 
l :RE AD --- CHARACTER READ PROCEDURE 


00 10 

C606 



LAP 

I ACNT 


00 11 

6C16 

0 0 1 6 


A DO 

alCIOB 

ADDRESS OF PROMPT C 

0012 

9C05 

0005 


ST A 

•DCTMP1 + 1 

PUT JN MIM-IOB 

00 13 

FBUC 

0 OF 0 


S 1 N 1 

STANDARD, 

OUTPUT,0 

00 14 

2 3F9 






0015 

0 0 30 



t X A 


CIB ADDRESS 


0 000 



IFF 

LSI305 


00 1 fe 

6 AD A 

OOF l 


ADD 

= C 7MPl 

ADDRESS OF MINI-IOB 





Enul 



00 17 

FBDA 

00F2 


JST 

SIU: 

DO OUTPUT 

0016 

F HD A 

0 OF 3 


JST 

WAIT : 

FOR DELAY 


00 19 


RF AX 

E DU 

:f> 


00 1 9 

F BU6 

0 0 F 0 


SINT 

ST ANDARD, 

INPUT,0 

00 1 A 

1 3F9 






0 0 1 H 

C60 7 



LAP 

7 

OP CUDE MASK 

O0 1 C 

84 19 

00 19 


ANl) 

alCOP 

MASK OFF OP CODF 

0 0 1 D 

D2 0 3 

0021 


CMS 

T*U 

COMPARE TO TWO 

00 IE 

F203 

0022 


JMP 

UNFMT I 

UNFORMAT TED 

0 0 1 F 

F234 

0 054 


JMP 

B I N I N 

BINARY 

0020 

F20C 

002D 


JMP 

RF A 3 

FORMATTED ASCII 

0 021 

0 0 0 2 


T*0 

* 

DATA 

2 

CONSTANT Twd (2) 




* 

* 

T ITL 

UNFMTI - 

UNFORMATTED INPUT 


0022 

0022 FHD 1 OOF4 
0023 FBD1 00F5 
0024 3242 0022 
0025 F3D0 0OF6 


UNFMTI ENU 

* 

JST 
J ST 
JUH 
JMP 


FETCH: get next character 

buffo: go put INTO buffer 

UNFMTI GU GET NEXT CHARACTER 

ton: END UF RECORD 




( 



II/3-83 


c 

- .— --- 

PAGE 0009 0 9/ 01 /76 09:97:37 


MACKU2 CA2) SI= 


0530 

0531 


0026 

0532 

0533 

0026 

FHCC 

0539 

002 7 

H9 0E 

0535 

0028 

F 625 

0536 

0537 


0029 

053« 

0539 

0029 

9C1D 

0590 

002A 

CO OF 

0591 

0028 

F 220 

0592 

002C 

FBC8 

0593 

0599 


0020 

0595 

0596 

002D 

FBC6 

0597 

002E 

FBC8 

0598 

002F 

A2C8 

0599 

0030 

9C25 

0550 

0031 

COFF 

0551 

0032 

F605 

0552 

0033 

D2C5 

0553 

0 039 

F60 7 

0559 

0035 

F60C 

0555 

0556 

0557 




CHRDS 

HU- 



* 



RF A 1 0 

EOU 


* 


00F3 


JST 

0 0 OF 


L D A 

0003 

* 

JMP 


RF A4 

EOU 


* 


00 10 


STA 



C A I 

0 09C 


JMP 

OOFS 

* 

JST 


RF A 3 

EOU 


★ 


OOF 9 


JST 

OOF 7 


JST 

OOF 8 


luR 

0025 


STA 



C A I 

0 02D 


JMP 

00F9 


CMS 

0 0 20 


JMP 

0029 

* 

JMP 


* 

FOU 


* 


HlX/IOX CHARACTER I/O DRIVERS 93302-1XE0 
RFA --- READ format i e d ascii 


% 

WAIT: 

/.TREOCNl 

WFA2 GO RESTART 

% MA yBE GOOD 

HARROW SET FLAG 

jOF IS IT BACK ARRUW? 

RFA9 YES, BACK UP 

BUFFO: PUT INTO BUFFER 

% L 0 0 P 

GET CHARACTER 
IF FILE MARK, GOODBYE 

HIGH-ORDER BIT ON 
IS IT RUhUUT? 

YES, IGNORE IT 

HOW ABOUT A CARRIAGE RETURN? 
TOO SMALL 
GOT A LIVE ONE 


fetch: 

eofck: 

=: BO 
alCDCHNi 
:FF 
RFA3 
= : 80 
RF A 3 
RFAO 


CARRIAGE RETURN 


t-8-t/lI 


PAGE 

0 0 0 5 

00/01/76 

09:47: 

37 

wfX/IOX CHARAC F E R I/O DRIVERS 93302- 

M A C k 0 2 

( A? ) 

S I = 

CHRD3 

H () = 


RFa --- 

READ FORMAT TED ASCI1 

0559 




* 




0560 




A 

FOUND 

CARPI AGE 

RF TURN 

0561 




A 




056? 

00 56 

C 6 0 4 



LAP 

PROMP r 

PROMPI ABLE BI T 

0 56 3 

0037 

84 1 F 

0 0 1 F 


AND 

-i/CF UN 1 

TS IT? 

056a 

0 0 38 

?1 OC 

0045 


J A / 

RE A 1 

IE NOT , GET GUI 

0565 

00 39 

C 6 0 3 



LAP 

tORMSK 

MASK FOP EOR TYPE 

0 566 

0 0 3 A 

84 3 8 

00 IF 


AND 

<i>C F UN 1 

GET EOR TYPE 

05b 7 

0 0 3H 

COO? 



C A I 

2 

IS If CR/I.F ? 

0 56 6 

U03C 

F 20 1 

003E 


JmP 

f + ? 

YES, ECHO LINE FEED 

05b9 

0030 

F 20 7 

0 0 45 


JMP 

RF A 1 

NO, FORGET LINE FEED 

0570 

0 0 38 

FBB4 

0 OF 3 


JST 

wait: 

DU A HICCUP 

057 1 

0 0 35 

F8B0 

OOF 0 


stn r 

standard 

,OUTPUT,0 

057 1 ♦ 

o o a o 

?3F9 






057? 

ooai 

8 25 0 

0092 


LD A 

CRLFt 1 

LINE FEED 

05 73 

0042 

9C?5 

0025 


ST A 

«>CDCHN3 

DATA CHARACTER 

057a 

0043 

8422 

0 0 22 


LD A 

niCDCHN 

POINER TU MINI-I OH 

05/5 

00 44 

FBAD 

00F2 


JST 

S .1 u: 

OUTPUT 

0576 




A 




05 7 7 


0045 


PFA1 

EQU 

J> 

CHECK FOR VALID RECORD 

0578 




A 




0579 

0 0 4 5 

BC1U 

0 0 1 D 


EDA 

<i ARROW 

CORRECTION FLAG 

0580 

0 0 46 

CODE 



CA 1 

: OF 

LAST CHARACTER HACK ARROW 

0581 

0 04 7 

F 62 1 

0026 


JMP 

RFA 1 0 

YES, DU IT OVER 

056? 

0 0 4 8 

B40E 

OOOE 


LD A 

mREOCNr 

RESTART ADDRESS 

0583 

0049 

1 3 DO 



Lk A 

1 

MAKE IT WURO 

0584 

004 A 

9C18 

0018 


SI A 

fi*CBUF F 


0585 

U 0 48 

F3AE 

0 0 K A 


JMP 

EOF o: 

CHECK FOR END OF ERE 

0586 




A 




0587 


0 04C 


UFA 9 

EOU 

% 

BACK ARROW FOUND 

0588 




A 




0589 

0 0 4 C 

B 4 1 C 

0 0 1 C 


LD A 

<i'C 1 C N I 

CURRENT COUNT 

0590 

0041) 

2160 

0 0 20 


J A 7 

R F A 3 

IF AT BEGINNING 

0591 

0 0 4 E 

OODO 



DAR 


DOWN ONE 

059? 

0 0 4F 

9C1C 

0 0 t C 


SI A 

o»c i cn r 

RESTORE IT 

0593 

0050 

B41B 

00 18 


Li) A 

mCBUFF 

* * 


p 



PAGE 0006 1.19/01/76 09:a/:37 RIX/IUX CHARACTER I/O DRIVERS 93302-1XF0 


MACRU2 

( API 

51 = 

C HR 1)5 

BU = 

RF A- 

RfcAD FORFAITED ASCII 

059a 

0595 

0 051 

0 0 52 

o ooo 
9C1R 

0 0 1 B 

DAR 

ST A 

<>)CBUFF 

* DECREMENT BUFFER ADDRESS 

* * 

0596 

0053 

F6?6 

0 0 2D 

JMH 

RF A3 

GO GET NEXT 







II/3-86 


PAGE 0007 09/01/76 09:47 

HACROa (A?) SI- CHRDS hU= 


0598 




* 

0599 




★ 

0600 


0 05 4 


B I N 1 N 

0601 

0054 

FB9F 

0 OF 4 


060 a 

0055 

COFF 



0603 

0 05b 

F 2 02 

0059 


060 4 

0057 

F B9F 

OOF 7 


0605 

0058 

F 604 

0 0 54 


0606 




* 

060 7 




* 

0608 




* 

0609 

0059 

0 110 



0610 

0 0 5 A 

9C0D 

OO'JD 


061 1 

0 0 5b 

F B9B 

0 0 F 4 


061 a 

0 0 5C 

1 35 7 



0613 

005D 

9C1D 

0 0 1 D 


0614 

0 0 5 E 

F B95 

0 0 F 4 


0615 

005F 

A4 ID 

0 0 1 D 


0616 

U 0 6 0 

3101 

0062 


0617 

0061 

F 399 

OOFB 


0618 




* 

0619 




A 

0620 




A 

0621 

0 0 62 

0310 



0622 

0063 

9C0E 

OOOE 


0623 




★ 

0624 


0 0 64 


NEXT1 

0625 




At 

0626 

0064 

FB8F 

OOF 4 


0627 

0065 

FB8F 

00F5 


0b2H 

0066 

DC OE 

0 OOF 


Ob?R 

0067 

F60 3 

0 0 64 


0630 




A 

0631 




A 

0632 




A 

0633 

0068 

C6FF 




o 


17 Kr//I(JX CHARACTER I/O DRIVERS <>3302-IXE0 
HININ --- INPUT BINARY ROUTINE 

READ A BINARY RECORD 
FIND THE RECORD HEADER 
tUU S 

JSF FETCH: get A CHARACTER 

C*I :E F IS IT A RUdOUT 

J M P * + 3 YES GO GET BYTE CUUNI 

JS1 EOFCK: CHECK FOR /* 

J MP H[NlN 

GET THE BYTE COUNT 

Z AR 

ST A aiCCSUM CLEAR [HE CHECKSUM 

JST FETCH: GET FIRST CHARACTER 

LI A 8 SHIFT TO HIGH ORDER BYTF 

STA "i) C D A A SAVE IN TEMP CELL 

JST FETCH: GET SFCUND CHARACTER 

I OR o/CDAA MERGE THE T*U BYTES 

JAN $ + 2 NOT AN END OF FILE 

JMP EOF: AN END-OF-FILE 

READ THE 1 NPIJT DAT A 

NAR 

STA niREQCN I SAVE REQUIRED COUNT 

EOU * GET NEXT ONE 

JST FETCH: GO GET NEXT BYTE 

jst buffq: go nufuf into buffer 

IMS o'REOCNT INCREMENT NUMBER UF BYTES 
JMP NEXT1 

PERFORM CHECKSUM 


LAP 


: FF 





II/3- 


PAGE 0006 09/01/76 09:47:37 

MACRU2 (A2) SI = CHPDS HU= 


P1X/10X CHARACTER I/O DRIVERS 93302-1XF0 
PFA --- READ FORMATTED ASCII 


0590 0051 0000 

0595 0052 9C1B 00 IB 

0596 0053 Fb?b 0020 


«»CBUFF 
PF A3 


* DECREMENT BUFFER ADDRESS 


GO GET MEXT 






II/3-86 


PAGE 0007 09/01/76 09:07:37 

MACK02 (A?) Sis CHRD3 bU= 


0598 
0599 
0600 
0601 
060 2 
0603 
0600 
0605 
0606 
0607 
060 8 
0609 
0610 
0611 
06 1 ? 
0613 
0614 
0615 
0616 
0617 
0618 
0619 
0620 
0621 
0622 
0623 
0624 
0625 
0626 
0627 
0o2H 
0629 
0630 
0631 
0632 
0633 


0 05 4 

0054 FB9F 00F4 
0055 CUFF 
0056 F202 0059 
0057 FB9F OOF 7 
0 0 58 F 6 0 4 0 0 54 


0 059 
005A 
0 0 56 
0 0 6 C 
005U 
0 0 5 fc 
O05F 
0060 
0061 


0 110 
9COO 
F 898 
1 35 7 
9C1D 
F 895 
A 4 11) 
310 1 
F 399 


oo on 

0 0 F 4 

0 0 10 
U0F4 
0 0 1 D 
006? 
OOF R 


006? 0310 
0063 9C0E OOOE 

0 0 64 

0064 FR8F 00F4 
0065 FB8F 00F5 
0066 DCOE OOOE 
0067 F60 3 0064 


0068 C6FF 


* READ 

* FIND 
BIN IN £UU 

js r 

C A I 
JMP 
JS1 
JHP 


H T X / 10 X CHARACIER I/O DRIVERS 93302-1XE0 
HININ - INPUT BINARY RUUIINE 

A BINARY RECORD 
THE RECORD HEADER 
S 


FETCH 
:ff 
*+ 3 
F.OFCK : 
H [ N I N 


GET A CHARACTER 
IS IT A RUriOUT 
YES GO GE1 BYTE CUUNI 
CHECK FOR /* 


THE BYTE COUNT 


riCCSUM CLEAR [HE CHECKSUM 

FETCH: GEI FIRST CHARACTER 

8 SHIFT TO HIGH ORDER HYTF 

oJCDAA SAVE IN TEMR CELL 

FETCH: GET SECUND CHARACTER 

*CDAA MERGE THE T»U BYTES 

J+2 NOT AN END OF FILE 

EUF: AN END-OF-FILE 


READ THE INPUT D A I A 


niREQCNf SAVE REQUIRED COUNT 


NEXT1 EUU 


J ST FETCH: ( 

JST BUFFO: ( 

IMS o'REUCNT 
JMR NEXT1 

PERFORM CHECKSUM 

LAP : FF 


GET NEXT ONE 

GO GET NEXT BYTE 
GO OUFUE INTO BUFFER 
INCREMENT NUMBER OF BYTES 







II/3-87 


PAGh 0008 09/01/76 

MACW02 (A2) SI= C HR 1)3 


0630 

0 0 69 

0635 

006A 

0636 

0 0 6B 

0637 

006C 

0638 

0 0 60 

0639 

0 0 6E 

0600 

0 0 0 F 

0601 

00 70 

0602 

00/1 

0603 

0072 

0600 

00 7 3 


8000 000U 
9C1I) 00 ID 
Fdfib UOFO 
1 357 

9C0E OOOfe 
F'b 85 0 OF 0 
A OOF 0 001 
90 11) 00 ll) 
2101 0073 
H2B9 UOFC 
F389 UOFD 


09:07:37 
B0 = 

AND 
SI A 
JST 
LL A 
ST A 
JST 
KIR 
SUM 
J A 7 
Li) A 
JMP 


RTX/1UX CHARACTER 1/U DRIVERS 93302-1XE0 
BININ-INPUT BINARY ROUT INF 


HCCSUM MASK OFF LOW ORDER HI IS 

niCl) A A SAVE RECORD CHECKSUM 

F EIC H: FIRST BYTE 

8 SHIFT TO HIGH ORDER BY IF 

SREQCNT SAVE 

FETCH: SECOND character 

n'REOCN T MERGE TWO BYTES 

n>C DA A SUBTRACT COMPUTED CHECKSUM 

$ + 2 IF EVERYTHING OK 

sERROR ERROR CODE 

EORST: ERROR EXIT 


TT/3-88 


PAGE 

0009 

09/01/76 

09 

: a / : 

37 

W TX/IOX 

CHARACTER I/O DRIVERS 93302-1XEO 

MACR02 (A^1 

1 SI = 

CHRDS 


B0 = 


I: w IT F. 

- CHARACTER WRITE PROCEDURE 

06a9 




A 

* * 

AAA 

A A A A 

aaaaaaaaaaaaaaaa 

0650 




A 





0651 




A 


THIS 

ROUTINE 

WILL PROCESS ANY REQUESTS 

0652 




A 


TU OUTPUT TO 

A CHARACTER DEVICE. 

0653 




A 





0650 




A 


AFTER 

THE RFUUES1 HAS BEEN STARTED, CONTROL 

0655 




A 


WILL 

BE RETURNED TO THE 10 SCHEDULER 

0656 




A 





0657 




A 

* * 

AAA 

A A A A 

AAAAAAAAAAAAAAAA 

0656 




A 





0659 


00 70 


I: 

rite 

EUU 

* 


0660 




A 





0661 

007 a 

FH 78 

OOF 0 



SINT 

STANOARD,OU(PUT,0 

0661 + 

00/5 

23F9 







0662 

0 0 76 

801 A 

0 0 1 A 



LI) A 

alCRCNT 

REQUESTED COUNT 

0663 

007 7 

9C1C 

00 1C 



ST A 

QCTCNI 

SET TRANSFERED COUNI 

0660 




A 





0 665 




A 

WHA 1 WAS 

REQUEST 


0666 




A 





0667 

0078 

Cb03 




LAP 

3 


0660 

0079 

8019 

00 19 



AND 

a>COP 

MASK OFF OP-CODE 

0669 

00/A 

9C19 

00 19 



ST A 

n)C OP 

REPLACE NEW ONE 

0670 

0078 

C 0 0 3 




C A I 

3 

IF BINARY 

0671 

00/C 

F21E 

0098 



JMP 

RITE10 

FORMATTED binary 

0672 

0 0 70 

0030 




1 XA 



0673 


0000 




IFF 

LSI305 


067a 

007E 

8 A7F 

OOF E 



ADO 

sCRCNT 

ADDRESS OF DATA CHAIN 

0675 






ENDC 



0679 




A 





0680 


007F 


9 1 l E 1 

EUU 

$ 

DU IT TUIT 

0681 




A 





0682 

007F 

F872 

OOF 2 



JST 

SIO: 

START I/O 

0683 

0 080 

8019 

0019 



LDA 

o <C0P 


0689 

0 081 

C001 




C A I 

1 

IF UNFORMATTED 

0685 

0 082 

F 373 

OOF 6 



JMP 

for: 

GO TO END UF RECORD 

0686 




A 








II/3-89 


c 



PAGE 

0 0 10 

09/01/76 

09:47: 

3 7 

PTX/IOX CHARACTER I/O DRIVERS 93302-1XEO 

MACK02 (A2) 

SI = 

CMKOS 

80 = 


1 :RI TE 

--- CHARACTER WRIIE PRUCEDURE 

068 7 




* 

OUTPUT TRAILER 

RECORD 

0688 




* 




0689 


0083 


WTTE2 

eoij 

* 


0690 

0083 

F 8 6 F 

OOF 3 


js r 

BAIT: 

WAIT AWHILE 

0691 

0084 

C60 3 



LAP 

EORMSK 

END OF RECORD MASK 

069? 

0085 

84 IF 

0 0 1 F 


A NO 

n'CFUN 1 

MASK OFF THE EUR FLAG 

0693 

0086 

9C1H 

00 IB 


SI A 

ntCBUFF 


0694 

0087 

8 A 08 

0090 


ADO 

EUR8AD 

ADD START UF BUFFER ADDRESS 

0695 

0088 

BC1H 

0 0 1B 


EMA 

oJCOUFF 

PUT IT AND PICK UP FOR FLAG 

0696 

0089 

1 300 



LB A 

1 


0697 

008 A 

0150 



I AH 


CORRECT # OF CHARACTERS 

0698 

0088 

9C1 A 

001 A 


ST A 

ci>crcn r 

PUT INTO DATA CHAIN 

0699 

008C 

0030 



TX A 



0700 


0000 



IFF 

LSI305 


0701 

0080 

8 A 70 

0 OF E 


ADD 

sCRCNT 

DATA CHAIN ADDRESS 

0702 





6N0C 



0706 




* 




0707 


0 0RE 


LEAVE 

EQU 

3> 

CALL SIU: AND GO TO EUR: 

0708 




* 




0709 

008E 

F 863 

00F2 


JST 

Sin: 

START I/O 

0710 

0 08F 

F 366 

00F6 


JMP 

EUR: 

ALL DUNE 

0711 

0 09 0 

0 091 


EORBAO 

DATA 

CRLF 


0712 

0 091 

808 A 


CPLF 

DATA 

:8D8A, : 

8 A 8 D,:8D8A,:A08D 


0092 

8 A8D 







0093 

808 A 







0094 

A 0 80 






0713 

0095 

0000 


NULLS 

DATA 

0,0,0 



0 096 

0 0 00 







0097 

oooo 






0714 

0098 

FFOO 


EUF 1 

DATA 

:FFOO,0 



0099 

0000 






0715 

009 A 

AF AA 


E0F2 

TEXT 

' /*• 


0716 




* 




0717 


009B 


R1TE10 

EC4U 

$ 

formatted BINARY 

0718 




* 




0719 

0 09B 

0110 



ZAR 









II/3-90 


PAGE 0011 
MACPU2 (A2) 

0720 009C 

0721 0090 

0722 0 0 9fc 

0723 009F 

0724 
0725 
0726 

0727 0 0 A 0 

0 7 28 0 0 A 1 

0729 00A2 

0730 00A3 

0 7 31 o 0 A a 
0732 0 0 A 5 

0733 00A6 

073 0 0 0 A 7 

0735 
073b 
0737 

0738 00A8 

0739 

0740 00A9 

0701 

0705 0 0 A A 

0746 0 0 AB 

0747 0 0 A C 

0748 
0749 
0750 

0751 0 0 Al) 

0752 00AE 


09/01/76 
Sis CHKDS 

9COD 0 0 0 D 
8214 0082 
F853 00F2 
FB53 00F3 

0 0 A 0 

B41A 0 01 A 
9C25 0025 
C 6 0 2 

9C23 0023 
8422 0022 
FA2E 0004 
Fd4H OOF2 
F 848 0 0F3 

0 0 A 0 

0 0 30 
0000 

8A54 OOFE 

FA29 0004 
F1346 00F2 
F846 OOF 3 

0 0 AI.) 

CbFF 

8400 OOOD 


09:47*. 37 
80 = 

ST A 
LDA 
JST 
JST 

* 

RITE 11 EGU 
* 

LOA 
ST A 
LAP 
STA 
LOA 
JST 
JST 
JST 

* 

RITE 12 EUU 

* 

T XA 

IFF 

ADD 

ENDC 

JST 

JSF 

JST 

* 

HIT El 3 F.UU 
* 

LAP 

AND 


0753 OOAF 9C25 
0754 0080 8422 

0755 0081 F623 

0756 0082 0083 

0757 0083 0005 

0084 0096 


0025 

STA 

0022 

LDA 

0 0 BE 

J HP 


WHEDAO DATA 
RHEAD DATA 


IX/IOX CHARACTER I/O DRIVERS 93302-1XE0 

1 SRI IK CHARACTER WRITE PROCEDURE 

'tfCCSlJM CLEAR THE CHECKSUM BYTE 

RHEDAD RECORD HEADER TASK 

SIO: START I/O 

WAIT: WAIT AWHILE 

3> OUTPUT BYTE COUNT 

ntCKCNT RFOUESTFD COUNT 
<1)CUCHN3 POT INTO CIP 

2 TRANSFER COUNT 

HC0CHN1 PUT INTO DATA CHAIN 
alCDCHN DATA CHAIN ADDRESS 

1: UCS GO COMPUT CHECKSUM 

SIO: S(A R T I/O 

WAIT: WAIT AWHILE 

1 OUTPUT BINARY RECORD 


LSI 305 

=CRCNI DATA CHAIN ADDRESS 

I :OCS COMPUTE CHECKSUM 

SIO: START I/O 

WAIT: WAI1 A HI I 

$ OUTPUT CHECKSUM 

: E F 

alCCSUM MASK OFF CHECKSUM 

rtiCDCHN3 PUT INTO CIB 

atCDCHN DATA CHAIN ADDRESS 

LEAVE LEAVE BECAUSE YOU'RE DONE 

RHEAD 

5r NULLS*1 
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PAGE 0012 09/01/76 09:97:37 RlX/IOX CHARAC1EP I/O DRIVERS 9330?-lXE0 

MACRO? (A?) Sis CHRDS BU= I : FUN --- FUNCUONS 


0759 A*********************** 

0760 * 

0761 * 1HIS ROUTINE WILL PROCESS THE SPECIAL 

076? * FUNCTIONS REQUESTED FOR THE I/O DEVICES 

0 76 3 * 


0769 




* * * 

k * k 

0765 




* 


0766 


00B5 


i :fun 

ECU 

076 7 




* 


0766 

0 0B5 

FB3A 

0 OF 0 


SINT 

07 68 ♦ 

00b6 

?3F9 




0 769 

0 067 

C 6()F 



LAP 

0770 

00B8 

89 1 9 

0019 


AND 

0771 

00H9 

9C19 

0019 


ST A 

07 7? 

OOBA 

COOC 



C A 1 

0773 

0066 

f ?03 

OOBF 


JMP 

07 79 

ODBC 

COOD 



C A I 

0775 

OOBD 

F?() 8 

00C6 


JMP 

0776 

0 06E 

F 33 7 

00F6 


JMP 

0777 




* 


07 76 


OOBF 


FMARK 

EOU 

07 79 




* 


0780 

OOBF 

H9 IF 

0 0 1 F 


LD A 

0761 

OOCO 

1 3D? 



LPA 

078? 

00C1 

B?0F 

OOOl 


LD A 

0783 

0 0C? 

3201 

0 0 C 9 


JUR 

0789 

00C3 

F69 9 

00 7F 


JMP 

0785 

00C9 

661? 

0 06? 


LD A 

0786 

OOC5 

F 6?C 

OOF? 


JST 

0787 




* 


0788 


0 0C6 


PLEAD 

EQU 

0789 




* 


0790 

O0C6 

C 7 1 9 



LAM 

0791 

00C7 

9C 1 6 

0016 


STA 

079? 

00C8 

FH2A 

0 OF 3 


JST 

0793 

00C9 

B?09 

OOCE 


LDA 


****************** 

* 

standard,ouiput,o 

: F 

-DCUP MASK off op code 

ai LOP 

: C IF A c 

FMARK JMP to WRI1E file mark 
:D IF A D 

PLEAD JMP TO PUNCH LEADER 

EOR! GO TO END OF RECORD 

:i> WHITE FILE MARK 

'iiCFUNt SPECIAL FLAGS 

3 MOVE EOF HIT TO (JV 

SEUF '/*' FILE MARK 

E + ? 

R1 TE1 IF THAT'S IT, DU IT TUI T 
FEUF RUBOUT-NULL-NULL 

310: WRITE IT 

$ PUNCH LEADER 

?0 

^EXCESS SEI COUNT FOR ?0 TIMES 

WAIT: WAIT A BIT 

LEADER ADDRESS OF LEADER CHAIN 


k k 
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PAGE 

0013 

09/01/76 

09:07: 

37 

MACH02 

(A2) 

SI = 

CHRDS 

H0 = 


0790 

GOCA 

F627 

OOF? 


JST 

0795 

OOCB 

DC 1 6 

0 0 16 


IMS 

0796 

OOCC 

Fbliy 

OOC8 


JHP 

0797 

OOCU 

F328 

0 OF 6 


J HP 

0798 

OOCF 

0 U C F 


LEADER 

DATA 


OOCF 

000 6 





0 0 DO 

0095 




0 79'} 


0 0 HP 


F FOF 

E (JU 

0800 

0 0 0 1 

0 0 0 c 


SEOF 

DATA 


OOD? 

0 0 02 





0 0D3 

009A 





RTX/IUX CHARACTER I/O DRIVERS 95302-1XEO 
I : F U N -FUNCTIONS 

Sio: OUTPUT 6 NULLS 

o»EXCESS ARE WE DONE 

s-y no 

EUR: JHP END OF RECORD 

*+1,6,NULLS 


RHFOAD 
s+1» 2, EOF2 







TT/3-93 




( 


R age on ia 09/01//6 >^^ /; 3 7 

MACRO? ( A 2) SI= CURDS h,„ = 


RTX/IOX CHARACTER I/O DRIVERS ^ 3 S (J 1 X ^ 
1 : U C S - OUTRUl CHECKSUM 


0 8 0 2 

0 * 0 3 

r ! >J I J M 

0 » U 6 

n 8 o 7 
0 8 0 8 

0 8 0 9 
08 10 
0 8 11 
08 1 2 
0 8 1 5 
08 10 
08 IS 
08 1 6 
0817 
0818 
0 8 19 


* * 
* 

* 


* **** ********************** 

TUTS ROUTTNE WILL SEARCH 1HPIJ THE OUTPUT 
DATA CHAIN AMU CREATE. THE CHECKSUM FOR 
MF ENTIRE CHAIN 

CALLING SFUUENCF: 

JST UOCS 

4 REGISTER MUSI CONTAIN THE ADDRESS OF 
the first portion of toe chain 
The CHECKSUM is to re COMPUTED 
X REGISTER MUSI CONTAIN THE CIO ADDRESS 

RETURN STATUS: 

A REGISTER CONTAINS A 8 BIT CHECKSUM 


0 82 0 




* 

X 

REGISTER UNCHANGED 

0821 




♦ 

STATUS: 


0822 




* 


OVERFLOW 

-RESET 

0M23 




* 


REM A 1NDER 

IS UNCHANGED 

<)Hdu 




* 




082S 




* 

the 

COMPUTED CHECKSUM IS PLACED BACK IN 

0826 




* 

[HE 

C Iri 


082 7 




* 




0 828 




* * *■ 

* A 

****** 

************* 

0829 




* 




08 40 

onuu 

0 8 0 0 


i : 0 C S 

E n 7 



0 8 31 

0 0D5 

9 A 1 H 

OOEE 


SI A 

1 MP4 

SAVE DATA CHAIN ADDRESS 

0 8 42 

O ODE 

E A 1 8 

OOF IT 


SIX 

f M P 2 

SAVE Clh ADDRESS 

0833 

0 0 D 7 

oa on 

1)001) 


LuA 

tCCSUM 

CHECKSUM BYTE 

08 ja 

O 0 U 8 

9 A 0 A 

0 015 


SI A 

T:OCS5 

INITIALIZE CHECKSUM 

0 8 35 

0009 

S3 1 a 

OOEE 


LOA 

* 1 MP3 

NUMBER OF BYTES IN RECORD 

0836 

0 0DA 

04 1 (1 



NAN 



0 8 3 7 

OODH 

9 A 1 3 

0 0 F. F 


S T A 

COLIN ) 

SET BYTE COUNTER 


L 




II/3-94 


PAGE 

0015 

09/01/76 

09:47: 

37 

RTX/IOX 

CHARACTER I/O DRIVERS 93302-1XE0 

MACRO? (A?) 

Sis 

CHRDS 

80 = 


I : o 

C S --- OUTPUT CHECKSUM 

0838 

DO DC 

DAI 1 

OOEE 


IMS 

TMP3 

BUMP CHAIN POINTER . 

0B39 

UODO 

E 3 1 0 

OOEE 


LDX 

* TMP3 

BUFFER ADDRESS 

oflao 

oone 

1 328 



LLX 

1 

SET TO BY 1E ADDRESS 

0041 




* 




0842 


OuDF 


1: i) C S 4 

EOU 

* 

COMPUT CHECKSUM FOR NEXT 

0843 




* 




0844 

0 0 0 F 

OE 0 0 



SBM 


SET BYTE MODE 

0845 

0 0 E 0 

B 4 0 0 

0 0 0 0 


LDA0 

^0 

LOAD OUTPUT BY1 £ 

0046 

OOE 1 

OF 00 



$*M 


SET WORD MODE 

0047 

0 0 E 2 

FB1C 

OOFF 


js r 

Cksum : 

GO COMPUTE CHECKSUM 

0040 

0 0£ 3 

0 000 


1:0CS5 

DATA 


CHECKSUM DATA CELL 

0849 

00E4 

0 128 



I X R 


INCREMENT BUFFER ADDRESS 

0850 

OOE 5 

DA 09 

OOEF 


IMS 

COUNT 

INCPEMENT CUUNT DONE 

0851 

0 0 E 6 

F 6 0 7 

0 0 OF 


JMP 

I:0CS4 

NOT DONE 

085? 




* 




0853 


OOE 7 


[:0CS9 

EGU 

T 

ALL DONE SO CLEAN HOUSE 

0854 




* 




0855 

U0F.7 

06 0 4 

0 0 E 3 


EDA 

T J0CS5 

COMPUTED CHECKSUM 

0856 

0OF 0 

E 2 0 4 

OOED 


LDX 

IMP? 

RESTORE X REGISTER 

0857 

0 0c 9 

9C0D 

0 0 0D 


ST A 

o* C C S U M 

PUT CHECKSUM IN CTB 

0858 

OOE A 

H2 03 

OOEE 


LDA 

T MP3 


0859 

OOED 

0 0 D 0 



DAR 


RESTORE A REGISTER 

0860 

0 OF C 

E 7 1 8 

0 0D4 


K 1 N 

I :acs 

RETURN 

0861 

OOED 

0 u 0 0 


TMP2 

RES 

1 » o 


0862 

OOEE 

0 0 0 0 


1 MP3 

RES 

1 r 0 


0863 

OOEF 

0 0 0 0 


COUNT 

RES 

1 f o 


0064 


00 10 



LPUOl 




0 OF 0 

0 0 0 0 







OOF 1 

0 l) 0 4 







OOF? 

0 0 0 0 







OOF 3 

0 0 0 0 







00F4 

000 0 







0 0F5 

oooo 







OOFis 

000O 







OOF 7 

0000 







OOF 8 

0080 









( 





PAGE 0016 OV/01 /76 0V:a/:3/ RTx/lOX CHARACTER T/U DRIVERS R3302-1XE0 
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4P% 


uu 



o 

o 

o 

o 

c 

o 



X 

o 

o 

o 

o 

—1 

o 



o 

o 

o 

X 

o 

o 

o 


» r>, 

w 

c 

o 

^r 

c* 

X 

o 

CO 

z 








x 


cr 

< 

X 

CJ 

X 

Jj 

UL 

3 

z 

u_ 

UL 


Ci- 

u_ 

u_ 

'JL 

X 

X 

c: 

o 

o 

o 

X 

o 

o 

X 

<t 

o 

o 

o 

X 

X 

o 

o 

UJ 



in 

o 

o 

X? 

c> 

o 

X 

o 

o 

o 

o 

o 
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u 

0 0 0 0 

AkROW 

0 4 6 8 * 

0839* 

X 

0 000 

begin: 

0444 



0 60 0 

HININ 

0516 

0605 

X 

0000 

BUFFO: 

0 45 7 

0826* 

u 

0 0 0 0 

CHUFF 

0478 

0 4 8 4 * 

u 

0 00 0 

CCSUM 

0 6 1 0 * 

0634 

u 

ouoo 

COA A 

0613* 

0615 

u 

0 0 0 0 

CUCHN 

0574 

0 731 

IJ 

0 000 

C0CHN1 

0486* 

0 7 3 0 * 

u 

0 0 0 0 

C0CHN3 

0549* 

05 73* 

u 

0 0 0 0 

CFUNt 

056 3 

0566 

u 

0 0 0 0 

Cl OB 

0498 


X 

0 0 o 0 

CKSUM; 

0454 

0847* 

u 

0 0 00 

CUP 

0513 

0668 


0863 

CUUNT 

0 8 37* 

0 850* 

u 

0000 

CRCnT 

0662 

0 743 

067 4 


0712 

C RLE 

0572 

071 1 

u 

0000 

CICNl 

0489* 

0589 

u 

0000 

CTMP1 

0496* 

0499* 

u 

0000 

0 

0500 

051 1 

X 

oooo 

DELAT : 

0448 


X 

0 0 0 0 

END: 

0445 



07 14 

EOF 1 




0 715 

E0F2 

0800 


X 

000 0 

EOF ; 

0449 

06 17 

X 

0000 

EOFCK : 

0456 

0547* 

X 

oooo 

eofo: 

0459 

0585 

X 

0 0 0 u 

E OR : 

0450 

0528 


0711 

EORHAD 

0694 


u 

oooo 

EURMSK 

0565 

0691 

X 

OOOO 

EORvST: 

0451 

0644 

u 

oooo 

ERROR 

0643 


u 

oooo 

EXCESS 

0490 

0 791* 


0799 

feof 

0 785 


X 

0000 

FETCH: 

0455 

0639* 

0525* 


RTX/iUX CHARACTER I/O n^lvEf'S 9 3 3 0 
0579* 


054a* 0627* 

0584* 0893 0595* 0693* 0695* 
0720* 0752 0833 0857* 

0635* 0641 
0754 

0728* 0753* 

0692 0780 


0669* 0683 077 0771* 

0677 0698* 0/U1 0704 0727 0740 


0592* 0663* 

0503 0506 

0571 0661 0768 


0604* 

0685 0710 0776 079/ 


0795* 

0546* 0601* 061 1* 061 o* i rv . * 


-IX 



1 







II/3-97 


PAGE. 0002 09/01/76 09 : 59:99 


KfX/lOX CHARACTER 1/ 



0776 

FMAW* 

0/73 


N 

0766 

1 : F1JN 

0 9 36 



0630 

I: DCS 

0732* 

0795* 


0892 

IS0CS9 

0861 



0696 

i s ness 

0839* 

0855 


0653 

I:0CS9 



N 

0976 

] ‘.READ 

0939 


N 

0 659 

I:RITE 

0935 


li 

0000 

I A C N T 

0997 


U 

oooo 

INPUT 

051 1 



0796 

LEADER 

0793 



0 70 7 

LEAVE 

0 765 


u 

0 0 00 

LSI 305 

0 502 

0 5 11 5 




0 792 



0620 

nex r 1 

0629 



0713 

NULLS 

0 75 7 

0798 

u 

0 0 0 0 

OUTPUT 

0500 

057 1 


0766 

PLEAD 

0/75 


LJ 

00 0 0 

PRlJEiP 1 

0662 


u 

000 0 

REUCNT 

0 980* 

0539 


057 7 

KF A 1 

0569 

0569 


0631 

RF A 1 0 

05«1 



0062 

RF A? 

05 35 



0599 

RF A 3 

051 7 

0551 


0537 

RF A9 

0559 



056 7 

R F A 9 

059 1 



0510 

RF AX 

0 9° 1 



0 75 7 

RHF AD 

0756 



0 7 5b 

KHEDAD 

0 72 1 

0799 


0660 

HI TE1 

0 7 89 



0717 

R T T E 1 0 

06 7 1 



0725 

RITEl 1 




0736 

R IT E12 




0799 

R l T E 13 



N 

0669 

RITE2 

0937 



0600 

SEUF 

0782 


X 

0000 

SINT J 

0952 



0860 

060E> 0673 0676 070.- ' T" 

0661 0766 

0562 0622* 0626* 063"* 

0553 0590 0596 
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NTX/IUX CHARACTER I/O DRIVERS 9330?“I X 


X 

0000 

Siu: 

0 05 3 

0508* 




0786* 

0798* 

u 

0 0 0 0 

S TANDA 

0500 

051 1 

X 

0000 

SUHR: 

0986 


X 

0000 

s 11 h x: 

0 8 8 7 



0861 

I MP? 

0832* 

0856 


086? 

T8P3 

0 8 31 * 

0835 


0518 

Tw() 

0519 



0 5 ? 3 

UNFM’F I 

0515 

0527 

X 

0 0 0 u 

wait: 

0958 

0792* 

0 509* 


0865 SOURCE LINES 


0575* 068?* 0709* 07??* 0733* 0708* 
0671 0661 0768 

0838* 0839 0858 

0533* 0570* 0690* 07?3* <)7 38 * 0797* 
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SECTION 4 


DIB AND CIB DESCRIPTIONS 


The DIB and CIB are tables which are used in communication between IOX and a partic¬ 
ular I/O handler or the File Manager. 

The following DIB and CIB descriptions apply to all standard IOX handlers. DIB and 
CIB descriptions for non-standard handlers (for example, the IEEE Intelligent Cable 
handler) are included in Section 7 and for the File Manager, in Section 5. 

4.1 DEVICE INFORMATION BLOCK (DIB) - 11 TO 18 WORDS 

Words 0 to 10 are used by all IOX device handlers. Words 11 to 17 are used by 
specific handlers and the File Manager. 

Figure 4-1 illustrates the DIB configuration. 


II/4-1 
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DEVICE INFORMATION BLOCK 


STANDARD 
NAME * 

CHAIN 

DCIB 

QUEUE 

CN 

DSW 

DT 

DC UN 
DDEL 
DFUN 

DULS 

DERRC 


15 14 13 12 11 10 


0 word 


DIB CHAIN ADDRESS 


CIB ADDRESS 


USED BY IOX TO QUEUE REQUESTS 


COORDINATION NUMBER 


DEVICE SPECIFICATION WORD 


DEVICE NAME 


CONTROLLER NUMBER 


INPUT RTC TICKS 


UNIT NUMBER 


OUTPUT RTC TICKS 


FUNCTION 

CODE 

FUNCTION 

CODE 

FUNCTION 

CODE 

* 

FUNCTION 

CODE 

FILE 

MARK 

PF 

END OF 

RECORD 

MAX BYTES-ASCII 

MAX 

BYTES-BINARY 


HARDWARE ERROR COUNT (except MTIC) 


* 


ADDITIONAL WORDS USED 
BY SPECIFIC HANDLERS 


0 

1 

2 

3 

4 

5 | I OB 

> Words 1 

6 I and 2 

7 

8 

9 

10 
11 




17 


♦refer to the I/O Handler listing at the end of Section 3. 


Figure 4-1. DIB Configuration 
II/4-2 
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4.2 REGULAR DIB CONFIGURATION (ALL HANDLERS) 


WORDS 0 TO 10 


Word 0 

Word 1 

Word 2 

Word 3 
Word 4 


Word 5 
and 6 


Chain pointer to next DIB (CHAN directive). Last DIB contains 0. 

The DIB CHAN operand is X::. 

Associated CIB address. (See list of standard CIB names at the end 
of Section 4.) 

Used by IOX as a pointer to queue requests for this DIB. Initialize 
to zero. 

Device coordination number. Initialize to zero. 

Device Specification Word (DSW). Each of the 16 bits corresponds to 
the equivalent binary value described for bits 0-3 of IOB Word 5 
(opcode); e.g., if the device is capable of reading Formatted ASCII 
(which function, if requested by the IOB, would appear as 0010 in 
bits 0-3 in IOB Word 5) then bit 2 should be set on in the DSW. If 
the device can punch leader (1101 in bits 0-3 in IOB Word 5), then 
bit 13 (:D) should be set on in the DSW. 

Device Name. These words are copied into IOB words 1 and 2, respective¬ 
ly, upon finishing a call to 10:. These words contain four ASCII 
characters. Word 5 contains the first two characters which specify 
the device ("CR" for card reader, for example). Word 6 uses the 
following format for the third and fourth characters: 


IS 14 13 12 11 10 9 8 7 9 5 4 3 2 1 0 


_l__1_ 

_1_1_1_1_ 

1_1_1_l 

_1_( 

1_1_ 

□ 

I- 1- --1-- 


| | 

i 

j --Unit number (beginning 

! with ASCII 0) ■ 

--Contro 11 or number 

; I 

j (beginning with 1 

ASCTT O) 


For Fortran tasks using the teletype or lineprinter as a list: device 
with carriage control character recognition, or for a disk with end-of- 
file capability, the third character of the device name must be an r F ,: , 
to serve as a flag that the Fortran handler is to be used. 
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Word 7 


' Word 8 

i 

» 


! 


This word uses the following format: 


15 14 13 12 11 10 9 8 7 6 5 4 3 2_1_0 


i 1 

1 J .... 1 1 i 

1 1 

L 1_1 

I 1 1 

3 





1 



A 


RTC ticks after EOB 
(output) 

RTC ticks after EOB 
(input) 


Bits 8-15. A binary value representing the number of Real-Time Clock 
ticks to delay after an end-of-block interrupt for an input operation, 
before the device is considered available for the next I/O operation. 

Bits 0-7. A binary value representing the number of Real-Time Clock 
ticks to delay after an end-of-block interrupt for an output operation, 
before the device is considered available for the next I/O operation. 

This word contains function codes which are executed in Select instruc¬ 
tions to initiate an I/O operation if SIO: is called. 

The order of execution of the Select instruction within SIO: is: 


SEL 

DA,X 

SEL 

DA, 5 

SEL 

DA, 6 

SEL 

DA, Y 


This word uses the following format: 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


J-1 I — ^ —1 I — 1 - . 4 .., L - JL ■ I , _ I _ I _L 

A A 4 I 


.End of record action 

-Prompt flag 

-File mark indicator 

-Function code Y 
(output) 

-Function code X 
(output) 

-Function code Y 
(input) 

-Function code X 
( i rif nit ) 
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Bits 13-15. Contains function code X in the above sequence, for in 
input operation. 

Bits 10-12. Contains function code Y in the above sequence r for m 
input operation. 

Bits 7-9. Contains function code X in the above sequence, for an 
output operation. 

Bits 4-6. Contains function code Y in the above sequence, for an 
output operation. 

Bit 3. A flag signifying the type of file mark to be used for the 
device. 

1 = slash/asterisk 
0 = rubout/nll/nul.1 

Bit 2. A flag signifying whether the device is to be prompted before 
an input operation. 

I = Prompt the device 

0 - Do not prompt the device 

Bits 0-1. These bits represent the end of record action to be taken 
for Formatted ASCII output: 

00 = Output carriage return only 

01 = Output line feed only 

10 = Output carriage return and line feed 

II = Output space and carriage return 


NOTE 


Word 8 is set to zero for Distributed I/O and Disk DIB’s. 
Word 9 This word uses the following format: 

15 14 13 12 11 10 9 8 7 8 5 4 3 2 1 0 


Max i m iim re cor d sixe 
(ASCII I/O) 
Maximum record size 
(Binary I/O) 

Bits 8-15. Maximum record size (.in bytes) for formatted ASCII I/O 
operations. (Zero signifies unlimited record size.) 

Bits 0-7. Maximum record size (in bytes) for binary I O operations.. 
(Zero signifies unlimited record size.) 


LI/4-S 


1_1_I_1—Ji_J-1-^-1_8_1_(_I-1-L 
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Word 10 Cumulative hardware error count (must be incremented by the individual 

handler). Initialize to zero. 

| NOTE 

Word 10 is used differently by the Magnetic .Tape Intelligent Cable 
DIB. See the additional DIB configurations section. 


4.3 ADDITIONAL DIB CONFIGURATIONS - UP TO 18 WORDS 

The following DIB configurations require additional words which are not required in 
the regular DIB configuration. 


4.3.1 Distributed I/O DIB 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 word 


0 




I i /A~h 
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Word 11 DIO command fields. This word uses the following format: 

15 14 13 12 11 10 9 8 7 S 5 4 3 2 1 0 


Input: mode field 
Input branch adcires: • 
Output mode field 
Output branch address 

Bits 15-12. Branch Address Field of DIO Command Word for output. 

Bits 11-8. Mode Field of DIO Command Word for output. 

Bits 7-4. Branch Address field of DIO Command Word for input. 

Bits 3-0. Mode Field of DIO Command Word for input. 



4.3.2 Magnetic Tape Intelligent Cable DIB 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 wore 

0 

s 

! 
j 

i 

REGULAR DIB 

CONFIGURATION " 




I 1/4-7 
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Word 10 


Three MTIC error counters. This word uses the following format: 


16 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 



Rate 

Hard 

Hard 


errors 

errors 

error erasures 


Word 11 


Bits 11-8. The number of erasures due to hard errors. 

Bits 7-4. The number of hard errors. This counter is reset whenever 
an erasure occurs. 

Bits 3-0. The number of rate errors. This counter is reset whenever a 
hard error occurs. 


Basic mode select word. This word uses the following format: 


16 

14 

13 

12 

11 

10 

9 

8 

7 6 6 4 3 

2 1 0 

0 

□ 

0] 

1 

0 

0 

□ 

0 

—j _i i 4, .) 

1_1_1_ 


* 


Binary transport 
address 

Mode Select 


Examples - :FB00 indicates transport 0 
:FB03 indicates transport 3 

Word 12 This word contains the minimum record length (in bytes). Records 

smaller than this byte count are considered noise records. CIB word 35 
must specify the word address of a buffer with a size greater than or 
equal to the minim-urn record length. The standard minimum record length 
for the MTIC handler is 12 bytes. 

Write requests with a byte count less than the minimum record length 
will have additional characters appended to the record until the byte 
count equals the contents of word 12. Blanks are appended to ASCII 
records and zeros are appended to Binary records. 

Read request will return only the number of characters requested. 


» 
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-4.3.3 Disk DIB 

15 14 13 12 11 10 


9 8 7 


5 4 


i 0 word 

lo 


REGULAR DIB 
CONFIGURATION 


VER¬ 

IFY 

NOT USED 

DRIVE # STARTING SECTOR 

NUMBER OF SECTORS PER TRACK 

STARTING HEAD 

I 

N 

C 

NUMBER OF SECTORS 

PER CYLINDER 

STARTING CYLINDER j 

_ .. . S 

NUMBER OF SECTORS IN THE EXTENT 


I Word 11 


This word uses the following format: 

15 14 13 12 11 10 9 8 7 8 5 4 3 2 1 0 



-Starting sector 
-Drive number 
-Verify flag 


Bit 15. Verify flag 

Tf this bit is set, a verify operation will bo performed after each 
write'. Two additional attempts will bo made' to re-write the record 
before the error bit' in the status is set. 

Bits 14-7. Not used. 
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Bits 6-5. Drive Number 

This is the number of the drive attached to the controller. Its range 
is from 0 through 3 inclusive. 

Bits 4-0. Starting Sector 

This is the sector number where the extent is to start. Its range is 
from 0 through the number of physical sectors -1 per track. 

Word 12 This word uses the following format: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


Starting head 
Number of sectors per 
track 



Bits 15-8. Number of Sectors per Track 

This number defines the number of sectors on each track that this 
extent is to occupy. The sum of the number and the starting sector may 
not exceed the physical number of sectors per track. 

Bits 7-0. Starting Head 

This number defines the starting head number of the extent. Its range 
is from 0 through the number of heads -1 on the disk drive. 

Word 13 This word uses the following format: 


15 14 13 12 11 10 9 8 7 8 5 4 3 2 1 0 



cylinder number 


Bit 15. If this bit is set, the contents of bits 7-0 are incremented 
by 256. 

Bits 14-8. Number of Sectors per Cylinder 

This number equals the number of sectors per cylinder times the number 
of read/write heads. This is the maximum value of any extent. 

Bits 7-0. Starting cylinder 

This number is the first cylinder that the extent is to occupy. 
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Word 


4.3. 


Word 


CompulerAutomation 


14 Number of Sectors in the Extent 

This number is used to detect the end of the extent and to allow t le 
IOX disk handler to set the end-of-device status if access to the last 
sector of the extent or beyond is requested. This number is equal to 
the number of cylinders times the number of heads per cylinder times 
the number of sectors per track. 

Fortran Disk DIB 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 word 





i 


REGULAR DIB 
CONFIGURATION 


-y 


! 10 
i 


DISK DIB CONFIGURATION 


RANDOM ACCESS ADDRESS 


11 

1 :> 

I \ 

14 

15 


15 Random Access Address 

This word provides a location other than the user's IOB to store the 
record number. 
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Word 12 


Word 13 


' Word 14 

i 

j 


Word 15 


Word 16 


Word 17 


t 



Bit 15. Verify Flag 

If this bit is set, a verify operation will be performed after each 
write. Two additional attempts will be made to re-write the record 
before the error bit in the status is set. 

Bits 14-11. Drive Number 

This is the number of the drive attached to the controller. Its range 
is from 0 to 15 inclusive. 

Bits 10-0. Starting Head 

This number defines the starting head number of the extent. Its range 
is from 0 through the number of heads -1 on the disk drive. 

Bits 15-0. Starting Sector 

This is the sector number where the extent is to start. Its range is 
from 0 through the number of physical sectors -1 per track. 

Bits 15-0. Starting Cylinder 

This number defines the starting cylinder number of the extent. Its 
range is from 0 through the number of physical cylinders -1 on the disk 
drive. 

Bits 15-0. Number of Sectors 

This number is used to detect the end of the extent to allow the IOX 
Storage Module handler to set the end-of-device status if access to the 
last sector of the extent or beyond is requested. This number is equal 
to the number of heads per cylinder times the number of sectors per 
track. 

Bits 15-0. Fortran Record Number 

This word is only required for Fortran to provide a location other than 
the user's IQB to store the record number. 

Bits 15-0. Number of Sectors per Track 

This number defines the number of sectors on each track that this 
extent is to occupy. The sum of this number and the starting sector 
number may not exceed the physical number of sectors per track. 

Bits 15-0. Number <>f Sectors per Cylinder 

This, number defines the number of. sectors on each cylinder that this 
extent is to occupy. it is numerically equal to the number of sectors 
per track times the number of heads per cylinder. Note that the number 
of heads per cylinder plus the starting head number must not exceed the 
physical number of heads on the drive. 
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4.4 SAMPLE DISK DIB 

This DIB defines an extent on disk unit 0 of cylinders 0 through 10, heads 2 and 3, 


sectors 0-11? 
platter: 

that is, all 

sectors of the first 

eleven cylinders of the removable 


NAM 

D:DKXX 

DIB NAM 

★ 

EXTR 

C :DK0 

CIB Reference 

D:DKXX 

EQU 

$ 



CHAN 

X: : 

Chain link to other DIB's 


DATA 

C :DK0 

CIB Address 


DATA 

0 

IOX temp cell 


DATA 

0 

Coordination number 


DATA 

: 0011 

DSW: Direct access Read/Write 


DATA 

'DK, 'XX' 

Device name 


DATA 

0 

EOB delay (none required) 


DATA 

0 

FC's, flags (none required) 


DATA 

0 

Max record size 


DATA 

0 

Error count 


DATA 

0 

Drive 0, starting sector 0 

* 

DATA 

:C02 

Sectors per track = 12 
Starting head number = 2 

* 

DATA 

: 1800 

Sectors per cylinder = 24 
Starting cylinder number = 0 


DATA 

: 108 

Sectors per extent = 264 
(24 sectors x 11 cylinders) 


4.5 CONTROLLER 'INFORMATION BLOCK (CIB) - 38 WORDS (47 WORDS FOR STORAGE MODULE DISK) 

The CIB is used for storing and/or transferring information between IOX and the I/O 
handler. Words 15-19 must contain the described information upon initial entry to 
IOX. Words 22-31 have data stored in them while in IOX. All other words are used by 
the standard I/O handlers and IOX routines, but may not be required by the user's 
specially written handler. Figure 4-2 illustrates the CIB configuration. 

Each CIB location and its usage is described below: 


Word 0 


Word 1 


Words 2-11 


Word 12 


Temp cell. Set to zero by the scheduler to be used for beginning of 
record flag. Set to -1 by IORTN: or SIO:. Set to a number greater 
than zero by an interrupt. 

Temp cell. If the subroutine SIO: or EORST: is called, this word 
should contain a SEL DA, 7 instruction where DA=the device address of 
the device being accessed. 

Temp cells. CIB's for standard I/O handlers contain a calling sequence 
to the RTX INTQ: routine, which is executed upon an end-of-block inter¬ 
rupt. (See INTQ: description.) 

Temp Cell. The special function codes from DIB Word 8 are stored here 
by SINT:, and used by SIO: in setting up the I/O select instruction 
sequence. 
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Standard 
Name * 

C BOR 
CSEL7 


CTMP1 

CTMP2 

CTMP3 

CEBTSK 

CNEWA 

CNEWX 

CFUN 

CCSUM 

REQCNT 

CJTBL 


CSPLOP 

CDEL 

CINTR 

EXCESS 

CEOF 

Cl OB 

COP 
CRCNT 
CBUFF 
CTCNT 
CDA A 
CD I B 
CFUN 1 
STATUS 
CRTN 

CDCHN 

CDCHN1 

CDCHN 2 
CDCHN3 


CONTROLLER INFORMATION BLOCK 

15 14 13 12 i) 10 9 8 7 6 5 4 3 2 1 0 word 

TC FOP SIO:—BEGINNING OF RECORD FLAG 0 

TC FOR SIO: OR EORST:—SEL DA,7 1 



JST 

INTQ: 




DATA 

$ 

CALLING LOC 



DATA 

0 

TEMP 1 



DATA 

0 

TEMP 2 



DATA 

0 

TEMP 3 



DATA 

TASK ADDRESS 



DATA 

PRIORITY 

FOR QUEUED TASK 



DATA 

AREG 




DATA 

XREG 




DATA 

P-LOC 

CIB ADDRESS 


i_ 

TC FOR SINT: AND 

SIO:—FUNCT 

. CODES (DIB wd 8) 



TC FOR CHECKSUM 
TC 

ENTRY POINT TO READ 
ENTRY POINT TO WRITE 
ENTRY POINT TO POSITION 
ENTRY POINT TO FUNCTION 
ENTRY POINT TO SPECIAL OPERATION 
TC FOR SIO:—WATCHDOG TIMER INSTR. 

TC FOR SINT: AND SIO:—DEVICE WORD INTERRUPT ADDR. 
TC FOR I OX—PROMPT CHARS (I OB wd 8) 

TC FOR I OX—EOF, AND FOR MAG TAPE—RETRY CTR 
TC FOR IOX—IOB ADDR 

TC' FOR IOX SCHED—OP CODE AND STATUS (TOB wd 5) 
TC FOR IOX SCHED—REQUESTED COUNT (IOB wd t>) 

TC FOR IOX SCHED—BUFFER ADDR ( lOR wd 7) 

TC FOR IOX—ACTUAL BYTE COUNT 
TC FOR IOX SCHED—DIRECT ACCESS ADDR (TOB wd 9) 
TC FOR IOX SCHED—DIB ADDR AND BUSY FLAG 
TC FOR IOX SCHED—FUNCT. CODES (DIB wd 8) 

TC FOR EOR:—STATUS 

TC FOR SIO: AND WAIT:—RETURN ADDRESSES 


17 NOTE: 

TC = Temp Cell 

18 


DATA $+1 


DATA $+1 

DATA 0 


POINTER TO BYTE COUNT 34 
BYTE COUNT 35 
BUFFER ADDRESS 36 
1 CHAR INPUT BUFF 37 


*refer to the I/O Handler listing at the end of Section 3. 

Figure 4-2. CIB Configuration 
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Word 13 Temp Cell, Used by the standard I/O handlers for a checksum storage 

cell. 

Word 14 Temp Cell. 

Words 15-18 IOX requires these words to be set up as a jump table to various entry 
points in the I/O handler, as follows: 

Word 15 Entry point to READ. 

Word 16 Entry point to WRITE. 

Word 17 Entry point to POSITION. 

Word 18 Entry point to FUNCTION. 

If any of the above functions have no meaning to the handler, the cor¬ 
responding cell (Words 15-18) should be zero. 

Word 19 Entry point to SPECIAL OPERATION. If the handler does not perform a 

special operation, this word should be zero. 

Word 20 Temp Cell. This cell is assumed by SIO: to be an instruction (e.g., 

LLA or NOP) to be used in calculating the watchdog timer. (See SIO: 
routine description.) 

Word 21 Temp Cell. SINT: and SIO: routines expect this word to contain the 

device's word interrupt address. 

Word 22 Temp Cell. Used by IOX to store prompt characters from IOB Word 8, if 

any. 

Word 23 Temp Cell. Used by IOX character handler in checking for end of file, 

and by the magnetic tape handler as a retry counter. 

Word 24 Temp Cell. IOX scheduler routine stores IOB address here. 

Word 25 Temp Cell. IOX scheduler routine stores IOB Word 5 (op code and sta¬ 

tus) here. 

Word 26 Temp Cell. IOX scheduler routine stores IOB Word 6 (requested count) 

here. 

Word 27 Temp Cell. IOX scheduler routine stores IOB Word 7 (buffer address) 

here. 

Word 28 Temp Cell. Used by IOX routines to count actual byte transfers. 

Word 29 Temp Cell. IOX scheduler routine stores IOB Word 9 (direct access ad¬ 

dress) here, if any. 

Word 30 Temp Cell. IOX scheduler routine stores DIB address here, and later 

uses it for a busy flag. (If non-zero, IOX assumes the device to be 
busy.) 

Word 31 Temp Cell. IOX scheduler routine stores DIB Word 8 (function codes) 

here. 
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Word 32 
Word 3 3 


Temp Cell. Used by EOR: routine for storage of status. 

Temp Cell. Used by the SIO: and WAIT: routines to store their return 
addresses. 


Words 34-37 Temp Cells. Used by the standard I/O handlers as a byte count/buffer 
address/l-character buffer sequence for 1-character I/O calls to 
SIO:. (See FETCH: description.) 


NOTE 


MTIC Handlers use CIB words 34 and 35 in the following manner: 


Word 34 Temp Cell. Used to store the MTIC Hardware Status. This word uses 

the following format: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


_ 1 _ 1 _ 

_1_1_L_I 

_1_1_ 

1_ 1 _1_1_1_1_1_ 

7 l r » 


Status byte two 
Status byte one 


Word 35 Minimum Record Length Buffer Address. This word contains a word 

address of a buffer with a size greater than or equal to DIB word 12. 


4.6 STANDARD CIB NAMES 


The following table shows the CIB names 

for all devices for which 

standard and 


non-standard handlers exist within IOX. 

The label is 

to be used . 

as 

the second 

word of 

the associated DIB(s). (A table of DIB 

names is shown 

in section 

2 

- Unit Assignment 

Table description.) 








Fortran 



Fortrai 


Non-DIO 

Non- DIO 


DIO 

DIO 

Teletype 

C:TY0 

C: TYF 


C: TYD 

C:TYFD 

CRT 

C: TYO 

C: TYF 


C: TVD 

— 

High Speed Paper Tape Reader 

C: PRO 

C: PRO 


C: PRD 

C: PRD 

High Speed Paper Tape Punch 

C: PPO 

C: PPO 


C: PPD 

C: PPD 

Line Printer 

C: LPO 

C: LPF 


C: LPD 

C:LPFD 

Card Reader 

C:CR0 

C: CRO 


— 

— 

Disk 

C :DK0 

C: DKF 


— 

— 

Storage Module Disk 

C:SM0 

C:SMFO 


— 

— 

Floppy Disk 

C :FDQ 

C:FD0 


— 

— 

Magnetic Tape 

C :MT0 

C: MTO 


C: MC 0 

-- 

IEEE Intelligent Cable 

— 

— 


C:IEOD 

— 
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SECTION 5 
FILE MANAGER 


The File Manager provides directory and data management for file-oriented devices. 

The devices supported by the File Manager are the moving head disk and the floppy 
disk. It operates as a driver working in conjunction with RTX/IOX. By using the File 
Manager, an application program may communicate directly with the data files by n ime, 
independent of the physical medium storing the file. 

All requests for file access are made through IOX (10:) using Logical Units (LUNs). 

The File Manager calls standard IOX device drivers using Logical Units for the 
required physical I/O. LUN assignments for files as well as LUNs for use by the File 
Manager for physical I/O are made in the Unit Assignment Table (UAT). (See Section 2, 
IOB and UAT Organization.) File information (name, file attributes, etc.) is con¬ 
tained in a Device Information Block (DIB) for that file.. The file DIB is not to be 
confused with the device DIB described in Section 4 although the first ten words are 
the same. The file DIB is described in this section. 

The File Manager requires that all File-oriented devices be labeled prior to use. 

This involves the creation of a Volume Table of Contents (VTOC) and directories on 
each individual unit to allow later file processing by name. Do not confuse 
"labeling" with the "formatting" of disk packs; the latter must be done with stand¬ 
alone programs before labeling. The RTX File Label Utility (93324-40A1 and -41A1) 
is a stand-alone program for labeling file-oriented devices. The device labeled using 
this utility is compatible with the Computer Automation OS file format. This utility 
j is described in Section 5.3. 

5.1 FILE ORGANIZATION 

I File organization in the File Manager is compatible with the Computer Automation OS 
j file format. Any file-oriented device accessed through the File Manager must contain 
a directory. The directory describes by name all data files which reside on the 
device. The physical medium containing a directory and files is called a Volume. The 
first entry in the directory is the Volume Table of Contents (VTOC). This entry 
contains information for the File Manager as well as volume name and creation date. 

The remainder of the directory is segmented into file description entries, one for 
each file on that volume. An entry contains the file name, creation date and time, 
and File Manager information such as record size, block size and file length. See 
Figure 5-1 for directory structure. Figure 5-2, the Disk Descriptor Table, defines 
the disk partition limits. 

For disk volumes, multiple new file,* writes are supported through disk partitioning. 

The di.sk is divided into as many as eight partitions, each of which may have a new 
file open. 11' a file extends; past l he end of a partition, the file is linked to the 
next available' partition. File linkage is supported for forward sequential reading or 
for positioning only (in oil her direction). Any number of old files may be open. 

(See F iguie 5-3 for file linkage.) 
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RELATIVE 

SECTOR 


VTOCRDs SEQUENTIAL FILE 

(blocked 32 bytes per record, 510 bytes per block) 


0 


RECORD 0 



NOTE: 

Directory may begin at 
absolute disk 
sector :0 or :29 


10 


VTOC 


FILE 1 


FILE 2 


FILE ATTRIBUTES: 

Bit 15 - 1 - Deleted 

BIT 14 - 1 = Random, 0 = Sequential 

BIT 13 - 1 = Blocked, 0 = Unblocked 


WORD 0 
1 
2 

3 

4 

5 

6 

7 

8 

\ ^ 

\ io 





c 

318 


319 





0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

i 14 
V 

\ 15 
\ __ 


:BFBF 


ASCII DATE 
DEVICE LABELED 


ASCII NAME 
OR VTOC 


# DIRECTORIES USED 


TOTAL # DIRECTORIES 


DISC ADDRESS 
OF DDT 



ASCII 
FILE NAME 


ASCII FILE 
CREATION DATE 


ASCII FILE 
CREATION TIME 


FILE ATTRIBUTES 


PROTECTION KEY 


8 


RECORD LENGTH (BYTES) 


BLOCK LENGTH (BYTES) 


TACH RATIO 


STARTING RECORD # 


TOTAL # RECORDS 


FILE LINKED 


Figure 5-1. Disk Directory Structure 
TI/5-2 


FILE DIRECTORY ENTRY 





iter Automation 


m 


1 PARTITION 


NOTE : 

Entry is zero i 
that partition 
does not exist 


4 

5 

6 

7 

8 

1 PARTITION 

2 

3 

4 

b 

7 

8 
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5.1.1 Sequential File Access 

Sequential file processing is available to the user on the moving head disk and the 
floppy disk. Sequential files are uniquely ordered by the File Manager: Given 
logical record N, the next READ request will always return logical record N+l. A READ 
or WRITE operation automatically advances the file to the next logical record. 

However f records may be accessed out of order by using the POSITION operation. 

The File Manager provides automatic blocking and deblocking of logical records under 
sequential access. All I/O requests access a single logical record whose position in 
the physical record is controlled by the File Manager and need not be known by the 
user. 

If the data security bit is set in the DIB f every sequential WRITE operation on that 
file will cause a directory update on the disk. 

For blocked files, the user must provide a record buffer and a blocking buffer. The 
size and address of each is in the appropriate DIB and IOB. The record buffer may be 
smaller than the file record size; however, the blocking buffer must be the block size 
plus two bytes. 

Only a record buffer is required for unblocked files. The record buffer may be 
smaller than the file record size. The user MUST reserve a word (two bytes) at 
address BUFFER -1 that is required for use by the File Manager. 

| Random Access 

With the File Manager, random access file processing is available only for disk 
devices. Random files are accessed by physical records; automatic blocking/deblocking 
is not provided. A random file must reside within a single partition. The number of 
data bytes contained in each record is fixed at 512. The medium-capacity disk sector 
size is 512 bytes. When using a floppy disk, four sectors are used for each random 
file record; each sector has 128 bytes. 

Although the record size of a random file is fixed, any number of bytes may be read or 
written. The specified record number is relative to the beginning of the file. 

| mote” 

T| »«' f CU'llI (| | I Mill) its I in Utlf-'l I * • I t' r; I f . • | cs ||i I . * t lilt. I I 11»• * * c ( ||.» M ' * I 

bytes are writ ten, the se< ten (s) beyond ( he mid ,d I i id wi I I I deni r<r/od 


To access a file in the random mode, the file must have been created as a random file. 
When a new file is opened with the random file type bit set in the DIB, a random file 
is created. When closed, the file size is equal to the largest relative record number 
accessed +1. 


5.1.2 File Opening and Closing 

The File Manager provides automatic file opening. On the first access (read, write, 
position, function) of the file, the File Manager will attempt to open the file. If 
the file name is found in the directory, the open and first access is completed. If 
the file name is not found, a new file is created. When creating a new file, the 
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partition number for placement of the file may be specified in the DIB. If not 
supplied (zero), the File Manager will use the partition having the largest unused 
space. Position to absolute file -1 to close the file. 


5.1.3 File Positioning 

File positioning is provided for use with sequential files. It allows the user to 
access logical records out of sequence. There are four basic types of positioning. 
With each type of positioning a count is specified by the user in the Input/Output 
Block (IOB word 6). (The IOB is defined in Section 2.) 

Note that counting of records or file marks begins at zero. See Figure 5-4 for 
examples of sequential file positioning. 

1. Absolute by file mark. The count is the number of file marks to skip from the 
beginning of the file. The next READ or WRITE will access the logical record 
following the file mark. Note that a position to absolute zero is equivalent to 
a rewind. Positioning a file to absolute -1 will close the file. If the count 
exceeds the number of file marks in the file, an "end-of-media" status is 
returned with the file positioned after the last logical record. 

2. Absolute by logical record. The count is the number of logical records to skip 

from the beginning of the file (the count must be positive). If a file mark is 

encountered before the count is exhausted, a "file-mark-found" status is returned 
and the file is left positioned at the file mark. If the end-of-file is encoun¬ 
tered before the count is exhausted, an "end-of-file” status is returned and the 
file is left positioned after the last logical record. 

3. Relative by file marks. The count is the number of file marks to skip from the 
current file position. A positive count means skip forward; a negative count 
means skip backwards. While skipping forward, if the end-of-file is encountered, 
and "end-of-file" status is returned and the file is left positioned after the 
last logical record. In like manner, when skipping backward, a "beginning-of- 
file" status is returned and the file is positioned at the first logical record. 

4. Relative by logical record. The count is the number of logical records to skip 

from the current file position. While skipping forward, if a file mark is 

encountered, a "file-mark-found" status is returned and the file is positioned at 
the file mark. 

For backwards skips, if a file mark is found, a "file-mark-found" status is 
returned and the file is positioned after the file mark. As with relative 
positioning by file marks, the File Manager will not allow the position to go 
beyond the beginning and end of file limits. 

With a normal completion, the actual number of records/file marks skipped is returned 
to the user in IOB word 8. For an error completion, the count returned is the number 
successfully skipped when the error occurred. For a retry, the requested count should 
be set to the REQUESTED count in the IOB minus the ACTUAL count. 
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5.1.4 File Functions 

The File Manager provides the functions described below. They are set by the user in 

This function writes a sequential record (blocked 
or unblocked) that contains a :80 in the first 
byte. When read, this record will cause a file- 
mark-found status to be returned. Note that this 
is a data separator, not an end-of-file. 

This function sets the file-deleted bit in the file 
DIB and in the directory when the file is closed. 
Note that this does not free the space on the file 
device; it only enables a new file to be ere ited 
with the same name. 

This function causes the directory to be updated 
with the current end of file. This function is 
valid only for new files. This enables the user to 
secure the data without performing a close on the 
file. 


the IOB (see Section 2) . 
Write File Mark 

Delete File 

Update Directory 
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NOTE: The number indicates the count supplied by the user. 


ABSOLUTE POSITIONING 


RELATIVE POSITIONING 


FILE MARK OR RECORD -1 


CLOSE FILE 


FILE MARK OR RECORD 0- 


•BEGINNING OF DEVICE 


RECORD 


.FILE MARK -100 


RECORD 1 


RECORD 3 


RECORD 


RECORD 


RECORD 


RECORD 100. 


FILE MARK -1 


FILE MARK 1. 


.RECORD -100 


RECORD 


RECORD 


RECORD 


RECORD 


RECORD 


RECORD -1 


START HERE 


RECORD +1 


RECORD +2 


RECORD +100 


FILE MARK 2. 


■’ILE MARK +1 


RECORD 


RECORD 


FILE MARK 3. 


.FILE MARK +2 


RECORD 


RECORD 


RECORD 


■FILE MARK +100 


FILE MARK 100 


END OF FILE 


Figure 5-4. Sequential File Positioning Examples 
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5.2 TABLE ORGANIZATION 

The File Manager may be considered as a "dummy" IOX driver in that it is a "da :a" 
driver as opposed to a device driver. The File Manager is only concerned with the 
data contained on the device and not the device itself. Since the File Manage-* is 
independent of the file device, it calls a standard IOX device driver to access datci 
on the device. These calls are made to 10: using the logical units associated with 
the device. 

Since the File Manager operates under IOX as a driver, it requires the same type 
driver tables (i.e. DIBs and CIBs). If the File Manager was equated to a devise 
driver, then a VTOC (directory) would be equivalent to a device controller, and a file 
would be equivalent to a device unit. The File Manager requires that one CIB tor each 
VTOC, and one DIB for each file be concurrently active (open). 

A device containing a VTOC to be accessed by the File Manager must have a unique 
logical unit associated with it. This logical unit is contained in the File Manager 
CIB for that VTOC and is used to access the device. 

Each File Manager DIB must have a logical unit associated with it. This logical unit 
is used by the user to access the file described by the DIB. 

Logical unit associations are made in the Unit Assignment Table (UAT). A description 
of the UAT, as well as of the Input/Output Block (IOB) that contains the LUN, is given 
in Section 2. 

Figure 5-5 gives an example of a table configuration. In this example, the file 
device is a moving head disk with two platters (unit 0 and unit 1). Each unit 
contains an independent Volume Table of Contents (VTOC) and file directory for that 
unit. 

The standard IOX moving head disk driver requires one controller information block 
(CIB) C:DK0 and two device information blocks (DIBs) D:DK00 and D:DK01 for disk units 
0 and 1 respectively. 

The File Manager requires two CIBs, C:FM0 and CsFMl, for VTOC 1 and VTOC 2, respec¬ 
tively. Since three files are to be active (open) concurrently, three DIBs are 
required: D:FM00 for FILE 1, D:FM01 for FILE 2 and D:FM02 for FILE 3. 

Each file device (VTOC) has a logical unit associated with it which is used by the 
File Manager to access the device (LUN X for VTOC 1 and LUN Y for VTOC 2) . 

The user accesses the files through a standard IOX call to 10: using the logical unit 
associated with the file DIB. (LUN A for FILE 1, LUN B for FILE 2 and LUN C for FIXE 3. 


5.2.1 File Device Information Block (DIB) 

The first ten words of the Device Information Block (DIB) have essentially the same 
functions for the File Manager as they have for IOX. These standard functions are 
described in Section 4, DIB and CIB Descriptions. The functions for words 10 through 
26 are given below. (Refer to Figure 5-6.) 

Words 0-6 Standard for IOX. 

Words 7-9 Standard for IOX, but must be set to zero for File Manager. 
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Figure 5-6. DIB Definition when Used with the File Manager 
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Physical I/O error status. The status (word 5) of the physical 
I/O IOB is stored here after each operation. 

File Status word. For old files, all bits are supplied by the 
File Manager from the directory; therefore, all bits of word 13- 
are initialized to zero. When creating a new file, those bits 
flagged with an asterisk (*) must be supplied by the user before 
the first access. The data security bit may be modified at any 
time to enable or disable this function. After the first access 
of a file (new or old), if the file delete bit (15) is set, the 
file will be deleted when the file is closed. Bits 15-13 corres¬ 
pond to the file attribute bits in the directory entry and are 
transferred to the entry when a new file is closed. 

Bit 15. 0 - keep file, 1 = delete file 

Bit 14*. 0 =*- sequential file, 1= random file 

Bit 13*. 0 = unblocked records, 1 = blocked records 

Bit 12. 0 = file closed, 1 = file open 

Bit 11. 0 = file open for sequential access 
1 = file open for random access 

Bit 10. 0 = old file, 1 = new file 

Bit 9. 0 = current block not modified 

1 = current block modified (blocked files only) 

Bit 8. Data security bit. When set the directory is updated 
after each sequential write (unblocked files) or after a block is j 
written (blocked files). 

Bit 7. 0 = file not linked, 1 = file linked 

Bits 6-4. Reserved for future expansion. 

Bits 3-0*. Partition number. For old files, contains the number. 
For new files, specifies where the new file is to be created. If 
zero, the available partition with the greatest unused space is 
used and its number is stored here. 

Words 12-14* ASCII file name. Supplied by the user. 

Word 15 Relative record number. Relative to the beginning of the current 

file segment for linked files. With unlinked files, this word is 
the same as the absolute record number. 

Word 16 Absolute record number. The current file position relative to the 

beginning of the file. Note that the first record is record zero. 

Word 17* Record size in bytes. Set to 512 for random files. Supplied by 

user for new files. 

* Information supplied by user. 


Word 10 

Word 11 
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Word 18* 

Word 19 

Word 20 

Word 21 

Word 22 

Word 23 

Word 24* 

Word 25 

Word 26 


* Information 


Block size in bytes. Used for blocked files only. Supplied by 
user for new files. 

Number of physical records/block. Contains the number of 512 byte 
physical records required for a file block (blocked files) or 
record (unblocked files). Supplied by the file manager. Referred 
to as "tach ratio" under CAI OS. 

Physical record number of first record in file. Supplied by the 
File Manager. 

Total records in the file. For linked files, contains total 
records in current segment. Supplied by the file manager. 

Directory entry number for this file. Supplied by the file 
manager. 

Current block address. Contains the physical record number of the 
last block read. Supplied by the File Manager. 

Blocking buffer address, (Word address, no indirect). Supplied by 
user when accessing blocked files. Buffer size must be block size 
plus 2 bytes. Not required for unblocked or random files. 

Last physical record in partition. For new files, contains the 
last available record number. Not used for old files. Supplied 
by the File Manager. 

Completion status. Cleared upon entry into file manager and set 
when operation is complete. A bit is active when it is set to 1. 

Bit 15. Physical I/O error. An abnormal status was returned 
from physical I/O. The detail physical I/O status (DHST) word in 
the DIB contains word 5 of the CIB IOB used for the physical I/O. 

Bit 14. Device not labeled. A valid VTOC identifier was not 
found. This error can only occur during a file open. 

Bit 13. Directory full. No unused entries are available in the 
directory for the creation of a new file. 

Bit 12. Directory error. An error was returned from physical I/O 
during a direction read or write. Detail physical I/O status 
(DHST) word in DIB is set. This error can occur during a file 
open, close, or directory update. 

Bit 11. End of Media. The end of a partition was reached during 
write on a new file. It is valid for both sequential and random 
access modes. 

Bit 10. Partition(s) busy. The required partition for a new file 
creation already has a new file currently open, (partition is 
busy), or required partition is full. If no partition was 
specified, then all partitions are busy. 

supplied by user. 
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Bit 9-8, Reserved for future expansion. 

Bit 7. Access mode error. A sequentail access was made on a 
ramdom file or a random access was made on a sequential file, 
access type did not match file type in a new file open. 

Bits 6-2. Reserved for future expansion. 

Bit 1. Unable to close. Indicates a close was in process when an 
error occurred (file remains open). 

Bit 0. Unable to open. Indicated an open was in progress when an 
error occurred, (file remains closed). 



o 
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5.2.2 Manager Controller Information Block (CIB) 

The Controller Information Block (CIB) is used for storing and/or transferring infor¬ 
mation between the File Manager and the IOX I/O handler. Words 15-19 must contain the 
described information upon initial entry to the File Manager (actually to IOX) . 

Figure 5-7 illustrates the CIB configuration. The functions of each CIB word are 
described below. Word 0, words 15-19 and words 24-33 are defined the same for the File 
Handler as they are for IOX. 

Word 0 SIO: beginning of record flag. 

Words 1-10 IOB used by the File Manager for physical I/O; includes user- 

supplied LUN for the file device (IOB word 4 = CIB word 5). All 
other data in IOB is supplied by the File Manager. The IOB status 
word is transferred to the DIB physical I/O error status word after 
each 10: call. 

Word 11 Number of physical sectors per physical record (supplied by the 

File Manager). 

Word 12 Physical sector address of Volume Table of Contents (VTOC). 

Initialize to zero. The File Manager determines the VTOC address 
(0 or :29) on first open. 

Word 13 Address of Disk Descriptor Table (DDT) (supplied by the File 

Manager after first open). This is a physical record address. 

Word 14 Open/close buffer address. This word contains the word address (no 

indirection) of a 256-word buffer supplied by the user. This 
buffer is used by the File Manager for directory searching during 
open or close processing. 

Words 15-18 Entry point jump table. 

Word 15 Read FM:REA 

Word 16 Write FM:WRT 

Word 17 Position FM:P0S 

Word 18 Function FM:FUN 

Word 19 Special operation entry point. Not used; set to zero. 

Word 20 Current direction record number during open, or operation code 

during position/function processing (supplied by the File Manager). 

Word 21 Number of directory entries used during open, or absolute file 

position count during position processing (supplied by the File 
Manager). 

Word 22 Number of directory entries available during open or current file 

position during position processing. Supplied by the File Manager. 
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Figure 5-7* CIB Definition When Used With the File Manager 
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Word 23 


♦Words 24-33 
Words 34-38 


Words 39-42 


Partition busy flags. Each partition on disk is represented by a 
single bit. The bit position is equal to the partition number. 
With a maximum of 8 partitions numbered 1-8, only bits 1-8 are 
used. Bits 0 and 9-15 are unused. A partition busy flag is set 
when a new file is open in that partition and cleared when it is 
closed. Only one new file may be open in any one time. Supplied 
by the File Manager. 

Standard CIB definition. 

Subroutine return address save area. 


Word 34 
Word 35 

Word 36 
Word 37 

Word 38 


Level 5 subroutines: FM:PS 

FM:FN 

Level 4 subroutines: FM:RE 

FM:WR 
FM: OP 
FM :CL 

Level 3 subroutines: FM:DM 

FM: EOF 

Level 2 subroutines: FM:WBK 

FM:RBK 

FM:RLK 

FM:RLR 

Level 1 subroutines: FM:PIO 


Buffer for processing partition file linkage. 
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5.3 RTX FILE LABEL UTILITY 

The RTX File Label Utility is a stand-alone program for labeling file-type devices. 
The RTX/IOX File Manager requires that all file-type devices be labeled prior to use. 
This involves the creation of a Volume Table of Contents (VTOC) and directories on 
each individual unit to allow later file processing by name. Do not confuse 
"labeling” with "formatting” of disk packs? the latter must be done with stand-alone 
programs before labeling. The labeled device is compatable with Computer Automation 
OS File Format. 


5.3.1 Environment 

The Label Utility requires an LSI-2 or LSI-3/05 CPU with a minimum of 4K words of 
memory. The tape numbers (binary paper tape) are 93324-40A1 and -41A1 for LSI-2 and 
LSI-3/05, respectively. 


5.3.2 Program Operation 

After loading and executing, the Label Utility halts with P=:0100 and waits for the 
user to specify TTY I/O type: 

1. Standard option board TTY, set Sense switch OFF. 

2. DIO TTY, set Sense switch ON. 

To continue execution, depress RUN after setting the desired I/O Option. The Label 
program will then query the user for its variable information. When responding, 
certain keys on the keyboard have special functions. 

1. Return . The Return key indicates the end of a line of input and causes 
a carriage return and line feed to be generated. 

2. Back arrow The back arrow causes the previous character input to 

be replaced by the next character typed. Multiple characters may be 
replaced by typing the appropriate number of back arrows followed by the 
correction characters. 

3. Back arrow ( -—)/Return. A back arrow followed immediately by Return 
causes the entire current line to be ignored and replaced by the next 
line input. The Return causes a carriage return and line feed to be 
generated. 
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I" MOTE 

An invalid response to a query will result in the query being 
repeated. 

The Label Utility begins with the first query: 

DATE? (MMDDYY) 

The user should respond with a Volume Identification. It must consist of one to six 
characters, normally alphanumeric, although any characters are allowed. 

Example: Feb. 4, 1977 would be input as 020477. 

TIME? (HHMMSS) 

Entef the current time of day (hours, minutes, seconds). This time is saved in the 
VTOC. This time is NOT incremented by a real-time clock., This is a 24 hour clock. 

Example: 1:23 PM would be input at 132300. 

VOLUME NAME? 

The user should respond with a Volume Identification. It must consist of 1-6 
characters, normally alphanumeric, although any characters are allowed. 

TYPE AND UNIT NUMBER? 

The response is a two-character specifier of the physical device which is to be 
labeled. The specifiers are: 


DEVICE 

SPECIFIER 

Moving Head Disk, Unit 0 

DO 

Moving Head Disk, Unit 1 

D1 

Moving Head Disk, Unit 2 

D2 

Moving Head Disk, Unit 3 

D3 

Floppy Disk, Unit 0 

F0 

Floppy Disk, Unit 1 

FI 

Floppy Disk, Unit 2 

F2 

Floppy Disk, Unit 3 

F3 


DOES xx CONTAIN OS? 

If the device to be labeled (xx) contains a copy of the Computer Automation Operation 
System (OS) the user responds with ,, YES M . Otherwise, the user's response is "NO", 
causing the next query to be suppressed. OS must be on the device before labeling. 


II/‘>-19 






Computer Automation 


SAVE OS? 

If an operating system exists on the Unit and is to be saved, the user responds with 
"YES", otherwise "NO". 

If the device to be labeled is a disk, the next query is: 

NUMBER OF PARTITIONS? (1-8) 

The user now selects the number of partitions (1-8) into which the disk is to be 
divided and enters that value. Only the first digit entered is used. The number of 
partitions selected is the limit to the number of new files which may be open 
simultaneously (new file creation). 

The labeling process then begins. When successfully completed, the following message 
is output: 

LABEL COMPLETE 

If the selected device is off-line, not ready, write protected, or othewise mal 
functions during the labeling process, the following message is output: 

HARDWARE ERROR 
RETRY? 

If the user responds with "YES", the program will retry the label process. If the 
device still fails, the error message is repeated. If the user responds with "NO" , 
the labeling process is aborted and the Program continues with the next query. 

LABEL MORE? 

The user is offered the option of labeling another device or terminating the process. 
A "YES" response will cause a restart with the query "VOLUME NAME?". If the user 
wishes to change the date and time and continue, the response is "NO". A "NO" 
response will halt the CPU. Depressing RUN will restart the program at the beginning 
At this point, a new I/O option may be selected. 



The restart entry point is :0101. The LSI 3/05 version contains 
a software console routine for restarting (CNS0L3). 
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SECTION 6 


DEVICE-DEPENDENT CONSIDERATIONS 


The device-dependent functions of IOX are the responsibility of the individual device 
handlers. Initially IOX performs all parameter validation and error checking before 
control is transferred to the appropriate device handler. The device handler will 
execute the data transfer and perform the device testing. Note that the bit con¬ 
figuration for each function (bits 3-0 of IOB word 5) is listed below each operation 
in parentheses. 


6.1 STANDARD CHARACTER DEVICE HANDLERS 


6.1.1 Line Printer (LP) 


Write (formatted ASCII) 
( 0110 ) 


Outputs up to 132 (or less if the printer is not 
that wide) characters. 


Write file mark 
( 1100 ) 


Outputs /* in columns 1 and 2. 


All other function codes 


No I/O 


6.1.2 Teletype Keyboard (TK) 


Write (formatted ASCII) 
( 0110 ) 


Outputs up to 72 characters. Carriage return , line 
feed are appended to the end of each record. 


Write (unformatted) 
( 0101 ) 


Outputs up to 65,535 characters exactly as in the 
user's buffer. 


Read (formatted ASCII 
( 0010 ) 


Inputs from the keyboard until a carriage return is 
read. Standard character editing is active. 


Read (unformatted) 
( 0001 ) 


Inputs from the keyboard until the number of char¬ 
acters requested is input. 


Write File Mark 
( 1100 ) 


/* is output followed by carriage return, line 
feed. 


All other function codes 


No I/O 
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6.1.3 Teletype Console (TY) 
ready) 

Write (formatted ASCII) 
( 0110 ) 

Write (unformatted) 
( 0101 ) 

Read (formatted ASCII) 
( 0010 ) 


Read (unformatted) 
( 0001 ) 


Write File mark 
( 1100 ) 

All other function codes 


6.1.4 Teletype Reader (TR) 

Read (formatted ASCII) 
( 0010 ) 


Read (unformatted) 
( 0001 ) 

Read (formatted binary) 
( 0011 ) 


All other function codes 


6.1.5 Teletype Punch (TP) 

Write (formatted ASCII) 
( 0110 ) 

Write (formatted binary) 
( 0111 ) 

Write (unformatted) 

( 0101 ) 

Wi i ( «• I’ i I • • Mur k 
( 1 . 100 ) 

Punch Leader 
( 1101 ) 

All other function codes 


(implies tape reader or keyboard for input, whichever is 

Outputs up to 72 characters. Carriage return and 
line feed are appended to the end of each record. 

Outputs up to 65,535 characters exactly as in the 
user's buffer. 

Inputs (from the tape reader, if ready, otherwise 
from the keyboard) until a carriage return is read. 
Standard character editing is active. 

Inputs (from the tape reader, if ready; otherwise 
from the keyboard) until the requested number of 
characters is input. 

/* is output, followed by carriage return, line 
feed. 

No I/O 


Inputs up to 256 ASCII characters from the reader 
(does NOT echo on printer) until a carriage return 
is read. Standard character editing is active. 

Inputs from the reader (does NOT echo on printer) 
until the number of characters requested is input. 

Reads one binary record and checks the checksum. If 
a checksum error is detected, the error status will ; 
be set. 

No I/O 


Outputs up to 256 ASCII characters. Carriage return 
line feeds are supplied at the end of each record. 

Outputs up to 65,535 bytes in IOX binary format. 


Outputs up to 65,535 bytes exactly as in the user's 
buffer. 


Oul puts Kuboul ~Nu J 1 Null on the paper tape. 


Outputs 12 inches of leader. 


No I/O 
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Read (formatted ASCII) 
( 0010 ) 


Read (formatted binary) 
( 0011 ) 

All other function codes 


6.1.7 High Speed Reader (PR) 

Read (formatted ASCII) 
( 0010 ) 

Read (unformatted) 

( 0001 ) 

Read (formatted binary) 
( 0011 ) 

All other function codes 


6.1.8 High Speed Punch (PP) 

Write (formatted ASCII) 
( 0110 ) 

Write (formatted binary) 
( 0111 ) 

Write (unformatted) 

( 0101 ) 

Write File Mark 
( 1100 ) 

Punch Leader 
( 1101 ) 

All other function codes 


6.2 FORTRAN LIST DEVICE HANDLER 

6.2.1 Line Printer (LPF) 

Write (formatted ASCII) 

( 0110 ) 


One card will be read. The maximum number of bytes 
transferred is 80. If the first two columns contain 
/* an end-of-file is assumed. 

To be specified ... if the first two columns 
contain /* an end-of-file is assumed. 

No I/O 


Inputs from the reader until a carriage return is 
read. Standard character editing is active. 

Inputs from the reader until the number of character: 
requested is input. 

Reads one binary record and checks the checksum. If 
the checksum is in error the error status is set. 

No I/O 


Outputs up to 256 ASCII characters. Carriage return 
line feeds are supplied at the end of each record. 

Outputs up to 65,535 bytes in the IOX binary format. 


Outputs up to 65,535 bytes exactly as in the user’s 
buffer. 

Outputs Rubout, Null, Null on the paper tape. 


Outputs 12 inches of leader. 


No I/O 


Outputs up to 132 characters, preceded by a carriage 
control character ("1*’ = top of form, "O'* = double 
upspace, any other = single upspace). 
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Write file mark 
( 1100 ) 

All other function codes 


6.2.2 Teletype Keyboard (TKF) 

Write (formatted ASCII) 
( 0110 ) 


Write (unformatted) 

( 0101 ) 

Read (formatted ASCII) 
( 0010 ) 

Read (unformatted) 

( 0101 ) 

Write File Mark 
( 1100 ) 

All other function codes 


Outputs ”/* n in columns 1 and 2. 

No I/O 


Outputs up to 72 characters, preceded by carriage 
control character ("l" = top of form = 6 upspaces, 
”0” = double upspace, any other = single upspace). 

Outputs up to 65,535 characters exactly as in the 
user's buffer. 

Inputs from the keyboard until a carriage return is 
read. Standard character editing is active. 

Inputs from the keyboard until the number of char¬ 
acters requested is input. 

/* is output followed by carriage return, line feed. 


No I/O 


6.2.3 Teletype Console (TYF) (implies tape reader or keyboard for input, whichever is 
ready) 

Outputs up to 72 characters, preceded by carriage 
control character ("1" = top of form = 6 upspaces, 
»»n" - double upspace, any other = single upspace). 


Write (formatted ASCII) 
( 0110 ) 


Write (unformatted) 
( 0101 ) 

Read (formatted ASCII) 
( 0010 ) 


Read (unformatted) 
( 0001 ) 


Write File mark 
( 1100 ) 

All other function codes 


' 0 " 

Outputs up to 65,535 characters exactly as in the 
user’s buffer. 

Inputs (from the tape reader, if ready, otherwise 
from the keyboard) until a carriage return is read. 
Standard character editing is active. 

Inputs (from the tape reader, if ready? otherwise 
from the keyboard) until the requested number of 
characters is input. 

/* is output, followed by carriage return, line feed 
No I/O 
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6.3.1 Magnetic Tape (MT) 


Write (formatted ASCII, 
formatted binary, or 
unformatted) 

(0110, 0111, or 0101) 


Read (formatted ASCII, 
formatted binary, or 
unformatted) 

(0010, 0011, or 0001) 


Outputs 1 to 65535 bytes as a single record. 


Inputs one record up to 65,535 bytes. If the 
actual record is longer than the requested number 
of bytes, only the requested number will be input. 
If the actual record is shorter than the requested 
input, only the actual number of bytes are input. 
Up to ten retries will be made in the event of a 
parity error before an error status is returned to 
the caller. 





Position Relative Records 
( 1010 ) 


Position Relative Files 
( 1011 ) 


Position Absolute Records 
( 1000 ) 


Position Absolute Files 
( 1001 ) 


Write File Mark 
( 1100 ) 


Skips the number of records in the requested count. 
A positive count indicates forward skips. A 
negative count indicates backward skips. If a file 
mark is encountered during the positioning, the 
operation is terminated, and the number of records 
actually skipped (not including the file mark) is 
returned along with an end-of-file status. The 
tape is left positioned prior to the file mark (the 
file mark is never actually crossed and movement is 
effectively bounded within a pair of file marks). 

If an end of tape or beginning of tape marker is 
found during positioning, the operation is te 
terminated with the actual count returned and an 
end-of-device status. 

Skips the number of file marks in the requested 
count. A positive count indicates forward skips. 

A negative count indicates backward skips. Upon 
return, the tape is positioned past the last file 
mark skipped. If an end-of-tape or beginning-of- 
tape mark is encountered, the operation is termi¬ 
nated with the actual skip count returned, along 
with the appropriate end-of-device status. 

The tape is first rewound to load point, then 
skipped forward the number of records requested. 

The requested count must be positive. If the count 
is zero, the tape is left at load point. 

The tape is first rewound, then skipped forward the 
number of files requested. The requested count 
must be positive. If the count is zero, the tape 
is left at load point. 

A write file mark function is issued to the tape 
unit. 


All other operations 


No I/O 
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6.4 DISK, STORAGE MODULE DISK, AND FLOPPY DISK HANDLER 

6.4.1 Disk (DK), Storage Module Disk (SM), and Floppy Disk (FD) 

Writes to the disk the number of bytes specified by 
the user in IOB Word 6, to the relative record 
number specified in IOB Word 9- Upon completion of 
the operation, this record number is incremented. 

Reads from the disk the number of bytes specified 
by the user in IOB Word 6, from the relative record 
number specified in IOB Word 9. Upon completion of 
the operation, this record number is incremented. 

No I/O 


NOTE 


The Floppy Disk Handler supports only one floppy disk controller. The 
handler must not be used concurrently with a storage module disk controller. 

The Storage Module Disk Handler supports only one storage module disk 
controller. The handler must not be used concurrently with a floppy disk 
controller. 


Write Direct Access 
( 0100 ) 


Read Direct Access 
( 0000 ) 


All other function codes 



6.4.2 Fortran Disk (DKF), Storage Module Disk (SMF), and Floppy Disk (FDF) 

Write (formatted ASCII, Outputs to the disk the number of bytes specified 

formatted binary) by the user, to the relative record number main- 

(0110 or 0111) tained in DIB Word 15. Upon completion of the 

operation, this record number is incremented and 
stored into IOB Word 9. 


Read (formatted ASCII, 
formatted binary) 

(0010 or 0011) 


Position Relative Records 
( 1010 ) 


Inputs from the disk the number of bytes specified 
by the user, from the relative record number main¬ 
tained in DIB Word 15. Upon completion of the 
operation, this record number is incremented and 
stored into IOB Word 9. 

The requested count (positive or negative) is added 
to the current relative record number maintained in 
DIB Word 15. (No actual I/O occurs). The new 
record number is also copied into IOB Word 9. If 
the resultant relative record number is greater 
than the highest sector number in the extent, the 
highest sector number is stored, and the end-of- 
device status is returned. If the resultant rela¬ 
tive record number is negative, a zero (represent¬ 
ing the first record of the extent) is stored, and 
a beginning-of-device status is returned. 
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Position Absolute Records The requested count (which represents the actual 
(1000) record number to be positioned to) , is stored into 

DIB Word 15 and IOB Word 9. No actual I/O occurs. 
If the record number is greater than the highest 
sector number in the extent, the highest sector 
number is stored, and the end-of-device status is 
returned. If the record number is negative, a zero 
(representing the first record of the extent) is 
stored, and a beginning-of-device status is re¬ 
turned . 

A two character record containing "/*" is written 
into the record pointed to by the Relative Record 
Count, then this count is incremented and copied 
into IOB Word 9. 

All other function codes No I/O. 


i wote i 

The Floppy Disk Handler supports only one floppy disk controller. The 
handler must not be used concurrently with a storage module disk controller. 

The Storage Module Disk Handler supports only one storage module disk 
controller. The handler must not be used concurrently with a floppy 
disk controller. 


Write File Mark 
( 1100 ) 


6.5 MAGNETIC TAPE INTELLIGNET CABLE (MTIC) HANDLER 


Write forward 
(ASCII or Binary) 
(0110 or 0111) 


Outputs 1 to 65,535 bytes as a single record. 
Records containing a byte count less than the 
minimum record length (DIB word 12) will have 
additional characters appended to the record until 
the byte count is equal to the minimum record 
length. Blanks are appended to ASCII records and 
zeros are appended to Binary records. 


During write operation error recovery, the tape is 
backspaced one record and another write is attemp¬ 
ted. Up to ten retries are made in the event of a 
rate error (processor workload error). Up to three 
retries are made in the event of a hard error (tape 
error)? subsequently, a fixed length erase function 
is used to erase the hard error region and three 
more retries are executed. This erase procedure is 
executed up to ten times, at which point an error 
status is returned. (Note: Hard error recovery is 
modified if the Control Edit function is on. Refer 
to the Control Edit description.) 

Error counts for each type of recovery are returned 
to DIB word 10. 
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Read (forward, reverse) 
(ASCII, Binary), 

Read Reverse 

( 0010 , 0011 , 0000 ) 


Position Relative Records 
( 1010 ) 


Position Relative Files 
( 1011 ) 


Position Absolute Records 
( 1000 ) 


Position Absolute Files 
( 1001 ) 


Write File Mark 
( 1100 ) 

Control Edit 
( 1110 ) 


Inputs one record up to 65,535 bytes. If the 
actual record is longer than the requested number 
of bytes, only the requested number is input. If 
the actual record is shorter than the requested 
input, only the actual number of bytes are input. 

Up to ten retries are made before an error status 
is returned. 

Skips the number of records in the requested 
count. A positive count indicates forward skips. 

A negative count indicates backward skips. If a 
file mark is encountered during the positioning, 
the operation is terminated, and the number of 
records actually skipped (not including the file 
mark) is returned along with an end-of-file status. 
The tape is left positioned prior to the file mark 
(the file mark is never actually crossed and 
movement is effectively bounded within a pair of 
file marks). If an end of tape or beginning of 
tape marker is found during positioning, the 
operation is terminated with the actual count 
returned with an end-of-device status. 

Skips the number of file marks in the requested 
count. A positive count indicates forward skips. 

A negative count indicates backward skips. Upon 
return, the tape is positioned past the last file 
mark skipped. If an end-of-tape or beginning-of- 
tape mark is encountered, the operation is termina¬ 
ted with the actual skip count returned with the 
appropriate end-of-device status. 

The tape is first rewound to load point, then 
skipped forward the number of records requested. 

The requested count must be positive. If the count 
is zero, the tape is left at load point. If the 
count is minus one, the unit is placed offline. 

The tape is first rewound, then skipped forward the 
number of files requested. The requested count 
must be positive. If the count is zero, the tape 
is left at load point. If the count is minus one, 
the unit is placed offline. 

A write file mark function is issued to the tape 
unit. 

This function causes the formatter to implement 
special head positioning to allow record updating. 
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Control Edit needs to be used with 
caution because of possible "tape 
creep". Refer to the Distributed 
I/O System User's Manual, Publication 
No. 91-53629-00B2, for a more 
detailed explanation. 

Control Edit requires five calls to 10:. Call one 
positions the tape at the end of the record to be 
updated. (An inter-record gap containing an era¬ 
sure or noise record might be found between the end 
of this record and the beginning of the next rec¬ 
ord.) Call two sets the edit function on. Call 
three performs a skip or read reverse function for 
the current record. Call four performs a write 
forward function for the new record. The byte 
counts for the new and old records must be equal. 
Call five set the edit function off. 

Hard error recovery for write operations is mod¬ 
ified when Control Edit is on. Up to three retries 
are made in the event of a hard error; subse¬ 
quently, an error status is returned. 

Control Erase This function performs a fixed length (filemark) or 

(1111) variable length erase. The erase mode bit is set 

to override a write operation. This function can 
be used with Control Edit to erase a record in 
place. 

Control Erase requires three calls to 10:. Call 
one sets Control Erase on. Call two performs a 
write or write file mark function. Call three sets 
Control Erase off. 

All other function codes No I/O. 


6.6 STANDARD CHARACTER EDITING 

In order to facilitate input from an operator, IOX supports character editing on input 
from all keyboard and paper tape devices. Three editing functions are supported by 
IOX. 

1. Backsapce. Character backspace is implemented using the back arrow —) char¬ 

acter. One character is erased for each back arrow character input. Since it is 
impossible to physically backsapce on a teletype, the back arrows are echoed on 
the printer. Note that the character editing will take place over the length of 
the entire physical record, not just until the number of currently valid char¬ 
acters equals the requested count. 
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2. Ignore entire input. Occasionally the operator decides it would be easier to 
start over rather than backspace and correct all of the errors on the current 
input. IOX supports this by deleting the entire input and restarting whenever 
the back arrow is typed followed immediately by a carriage return. 

3. Ignore this character. This is useful when the input is from a paper tape which 
was prepared off-line on a teletype. The punch on a teletype has a local back¬ 
space feature, and the most common means of correcting a tape such that it prints 
proprely when read off line is to backspace the punch over the offending char¬ 
acter (s) and punch rubout(s) on top of them. IOX will read such tapes properly 
by ignoring all rubouts. In addition, IOX will read such tapes properly by 
ignoring all rubouts. In addition, IOX ignores all line feeds and all other 
characters whose ASCII code is less than :0D (e.g., bell, leader). 

Since an end-of-file is defined as a Rubout, Null, Null on paper tape, and since it is 
difficult to enter Rubout, Null, Null on a keyboard, IOX recognizes two different end- 
of-file marks in the standard character editing mode for formatted ASCII input. These 
file marks are Rubout, Null, Null or /*. Either of these character sequences input at 
the beginning of a record will cause an end-of-file to be recognized. 
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SECTION 7 

NON-STANDARD HANDLER DESCRIPTIONS 


Some IOX handlers do not conform to the standard IOB, DIB, and CIB configurations 
described in sections 2 and 4. This section describes the software tables and device- 
dependent functions of these IOX handlers. (The A/D, D/A handler is described in 
Publication No. 93325-00.) 


7.1 IEEE INTELLIGENT CABLE (IEC) HANDLER 

The IEC Handler controls the operation of the IEEE Intelligent Cable. The IEC Handler 
and the IEEE Intelligent Cable together conform to the requirements for an IEEE (STD 
488-1975) interface system controller. The IEEE Intelligent Cable provides the hard¬ 
ware to drive the IEEE interface bus and the firmware to conduct both the Source 
Handshake and the Acceptor Handshake. It also senses the state of the IEEE Interface 
Bus. The IEC Handler implements the remaining IEC functions. The interfaced devices 
must have no controller capabilities. 

Refer to the Distributed I/O System User's Manual (revision B2 or higher) and IEEE 
I document 488-1975, "IEEE Standard Digital Interface for Programmable Instrumentation" 
for detailed IEEE function descriptions. 

Note that an arbitrary distinction is made between the terms "control" and "data" with 
respect to IEC handler message transfers. "Control" refers to bytes which are sent 
over the interface bus while ATN is true. "Data" refers to bytes which are sent or 
received over the interface bus while ATN is false. 
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7.1.1 IEC TOB Configuration — 9 to 12 words; 

Figure 7-1 illustrates the IOB configuration for the IEC Handler. 

INPUT/OUTPUT BLOCK 

FOR THE IEEE INTELLIGENT CABLE HANDLER 


Standard 

Name 15 14 13 12 11 10 987 6543210 


IDT 

ICUN or 
ITCB 

CN 

ILUN 

ISTA,IOP 

IRC NT 

I BUFF 

IACNT 

IRCNTU 

IBUFFU 

ITIME 


STANDARD IOB 

CONFIGURATION 


B 

U 

S 

Y 

~TT 

R 

NO 

BAD 


DE- 

OP OR 

IN- 

RES. 


OP 

OP 

R 

O 

R 

I/O 

LUN 

0 

VICE 

TERM 

COND. 

TERN 


§ 

CODE 

MOD. 


USED FOR ALL REQUESTED FUNCTION CODES 


USED FOR ALL REQUESTED FUNCTION CODES 


USED FOR ALL REQUESTED FUNCTION CODES 


USED IF OP CODE IS 00 OR 01 


USED IF OP CODE IS 00 OR 01 


USED TF OP CODE IS 00 OR 01 


word 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 


Figure 7-1. IOB Configuration 
IEC Handler 
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The format of the IOB after the first six words is determined by bits 3-0 of word 5. 


Format 1 


Op Code Op Modifier 

(bits 3 and 2) (bits 1 and 0) 


Function 


00 

00 

00 

00 

01 

01 

01 

01 


00 

10 

01 

11 

00 

01 

10 

11 


Write control and read to END or stop character. 
(CIB location CSTPCH is the stop character) 

Same as 0000 with parity standardization. 

Write control and read data to END. 

Same as 0001 with parity standardization 
Write control and write data. 

Write control and write data with END. 

Write control only. 

Write control and ignore data. 


Operations 0000 and 0010 require a DMA IOD or a standard 
IOD with a programmable stop character. 

15 14 13 12 11 10 9876543210 word 

6 

7 

8 
9 

10 
11 


DATA REQUEST COUNT 


DATA BUFFER ADDRESS 


ACTUAL DATA TRANSFER COUNT 


CONTROL REQUEST COUNT 


CONTROL BUFFER ADDRESS 


TIME LIMIT 


Word 6 Data Request Count. This word is supplied by the user to specify the 

number of data bytes to be transferred. This word must not be zero . 

Word 7 Data Buffer Address. This word is supplied by the user to specify the 

starting address of the data buffer. Note that this address is always 
a word address and that indirect addressing is not allowed. 

Word 8 Actual Data Transfer Count. This word contains the number of data 

bytes transferred when the operation is completed. This word is 
returned by IOX at the completion of I/O. 
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Control Request Count. This word is supplied by the user to specify 
the number of control bytes to be transferred. No control bytes are 
transferred if this word is zero. 


Word 10 Control Buffer Address. This word is supplied by the user to specify 

the starting address of the control buffer. Note that this address is 
always a word address and that indirect addressing is not allowed. 


Word 11 Time Limit. This word is supplied by the user to specify the operation 

time limit. If negative, there is no time limit. If positive, a 
"device unresponsive" error will occur if the read or write operation 
has not completed within the number of clock ticks specified. If zero, 
the operation time limit will equal the number of data bytes (IOB Word 
6) modified by the delay modification instruction stored into CIB word 
20. (Refer to the SIO: description in Section 3). 

Note that the specified number of clock ticks (word 11 positive) applies to data 
transfers only. The time limit for control transfers is always determined by the byte 
count and CIB word 20. 


j Format 2 

! Op Code Op Modifier 

(Bits 3 and 2) (bits 1 and 0) 

10 00 Wait for SRQ 


word 


6 


7 


8 


Word 6 Clock Ticks. This word is supplied by the user to specify the number 

of clock ticks before SRQ is found. No time limit is applied if this 
word is negative. If positive, a "device unresponsive" error will 
occur if SRQ is not found within the number of clock ticks specified. 
This word may not be zero. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 ] 0 


CLOCK TICKS 


NOT USED 


NOT USED 


8 are not used but must be provided. 
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Format 3 

Op Code Op Modifier 

(bits 3 and 2) (bits 1 and 0) 

11 00 Get IEC status 

11 10 Get parallel poll response 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 word 

6 

7 

8 

Words 6 and 7 are not used but must be provided. 


NOT USED 


NOT USED 


BYTE REQUEST 


Byte Request. This word is returned to the user by IOX. It contains 
the requested byte (either status or parallel poll response) . Figure 
7-2 illustrates the IEC status byte configuration. The parallel poll 
response will be returned in the low order byte. 


*6 14 13 12 11 10 9 8 7 6 8 4 3 2 1 0 



Not Data Accepted (SNDAC) 
IEC Busy (SBSY) 

Not Ready for Data (SNRF) 
Service Request (SSRQ) 

End (SEOI) 

Remote Enable (SREN) 
Interface Clear (SIFC) 
Attention (SATN) 


Figure 7-2. IEC Status Byte Configuration 
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Op Code Op Modifier 

(bits 3 and 2) (bits 1 and 0) 


Format 4 


Set IEC control lines 


15 14 13 12 11 10 9 8 7 6 5 4 3 


2 10 


NEW CONTROL LINE VALUES 


NOT USED 


NOT USED 


Word 6 


New Control Line Values, This word is supplied by the user to 
specify the new value of the IEEE control lines. Only lines ATN, 
REN , IFC, EOI , and SRQ can be changed. A "Get IEC status" 
operation should be performed prior to a "Set IEC control lines" 
operation to ensure that the values of other lines are not changed 
inadvertently. Figure 7-3 illustrates the IEC Set Mode Command 
Word Format. 


Words 7 and 8 are not used but must be provided. 


15 14 13 12 11 10 9 9 7 9 5 4 3 2 1 0 


00000 1 00 


0 0 0 


- Service Request (MSFQ) 
-End or Identify (MECI) 

■ Remote Enable (MREN) 
Interface Clear (MIFC) 
Attention (MATN) 


Figure 7-3. IEC Set Mode Command Word Format 


The following function codes are undefined: 


Op Code 


Op Modifier 












s 0-6 correspond to the regular DIB configuration described in Sec 
' are zeros. 


3 IEC CIB Configuration — 34 words 
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IEC CONTROLLER INFORMATION BLOCK 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

TC FOR IE: SIO—BEGINNING OF RECORD FLAG 


TC FOR IE:SIO—SEL DA,7 



DATA 0 


DATA 0 


DATA 0 


DATA INTP: 


CALLING LOC 



TASK ADDRESS 


DATA 8180 


DATA $-10 


DATA $-11 


CURRENT PICO IDLE STATE—INITIALIZE TO 0 


WATCHDOG FLAG FOR IE:SIO 


DATA IECR: 


15 NOTE: 


DATA IECW: 


16 TC * Temp Cell 


DATA 0 


DATA IECF: 


TC FOR IE:SIO—WATCHDOG TIMER INSTR. (NOP) 


TC FOR IE:SIO--!EC WORD INTERRUPT ADDR. 


TC FOR I OX— TIME DELAY FROM IOB 


TC FOR IOX—STOP CHARACTER 


TC FOR IOX—IOB ADDR. 


TC FOR IOX SCHED— OP CODE AND STATUS (IOB wd 5) 


TC FOR IOX SCHED—REQUESTED DATA COUNT (IOB wd 6) 
TC FOR IOX SCHED—DATA BUFFER ADDR (IOB wd 7) 

TC FOR IOX—ACTUAL DATA BYTE COUNT (IOB wd 8) 

TC FOR IOX SCHED—REQUESTED CONTROL COUNT (IOB wd 9) 


TC FOR IOX SCHED—DIB ADDR AND BUSY FLAG 


TC FOR IOX SCHED—CONTROL BUFFER ADDR (IOB wd 10) 


TC FOR EOF:—STATUS 


TC FOR IE: SIO—RETURN ADDRESS 



figure 7-4. IEC CIB Configuration 
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7.1.4 IEC Device-Dependent 

Write Control and Read 
Data to END 
( 0001 ) 


Write Control and Read 
Data to END with Parity 
Standardization 
( 0011 ) 

Write Control and 
Write Data 
( 0100 ) 


Write Control and Write 
Data with END 
( 0101 ) 


Write Control Only 
( 0110 ) 
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Considerations 

The contents of the control buffer (IOB word 10) 
are sent with the source handshake while ATN is 
true. The control buffer will usually contain 
interface commands which address a peripheral as 
the talker. The IEC then initiates the acceptor 
handshake. The peripheral will transmit data when 
ATN is false. The IEC receives data until an END 
message was received with a byte or the Auto I/O 
byte count reached zero. 

The handler will set bits 9 and 8 of IOB word 5 to 
the appropriate termination condition. The number 
of bytes transferred is returned to IOB word 6. 

A read data to END only operation is performed by 
issuing requested function code 0001 with the 
control request count (IOB word 9) equal to zero. 

This function is the same as function code 0001; 
during input, however, the I/O Distributor performs 
parity standardization on all data bytes. 



The control buffer is transmitted using the source 
handshake while ATN is true. The control bytes 
will generally address a peripheral to accept 
device programming. ATN is driven false following 
termination of the control sequence, and the data 
buffer is transmitted using the source handshake. 

A write data only operation is performed by issuing 
requested function code 0100 with the control 
request count (IOB word 9) equal to zero. 

This operation is the same as function code 0100 
except that the last byte of data is sent with the 
EOI control line true, indicating an END message. 

A write data with END only operation is performed 
by issuing function code 0101 with the control 
request count (IOB word 9) equal to zero. 

The control buffer is transmitted using the source 
handshake while ATN is true. The data request 
count (IOB word 6) must not be set to zero. The 
IEC will maintain control of the IEEE interface 
after the transfer by setting NRFD true. 
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Write Control and 
Ignore Data 
( 0111 ) 


Wait for SRQ 
( 1000 ) 


Get IEC Status 
( 1100 ) 

Set IEC Control Lines 
( 1101 ) 


Get Parallel Poll Response 

( 1110 ) 


All Other Function Codes 


The control buffer is transmitted using the source 
handshake while ATN is true. ATN is driven false 
and remains false following termination of the 
control sequence. Peripheral to peripheral data 
transfers may occur with the IEC in this state. 

Any read or write request following this function 
will be prefaced with a Take Control Synchronously 
operation so the IEC will regain control of the 
IEEE interface. 

The IEC is instructed to wait until the IEEE 
control line SRQ is found true. The handler will 
return immediately if SRQ is true when the request 
is made. 

The IEC status is returned to IOB word 8. 


IEEE control lines ATN, REN, IFC, EOI, and SRQ 
assume the values contained in IOB word 6. This 
function allows the transmission of interface 
messages which involve these control lines, such as 
"interface clear" and "remote enable". Note that 
the handler changes the values of all these lines 
when performing other operations. 

An IDY remote message is sent for parallel polling. 
When the IEC is ready, the handler returns the 
result of the parallel poll to IOB word 8. 

No I/O 


1 


| 

t 

j 

i 



7.2 A/D, D/A HANDLER PACKAGE (ADAHP) 

The Analog-Digital-Analog Handler Package (ADAHP) consists of six functional sub¬ 
routines which perform typical analog-digital (A/D) and digital-analog (D/A) conver¬ 
sions. The input subroutines allow the following capabilities: single input utiliz¬ 
ing internal and external trigger modes; repetitive inputs from the same channel with 
external and internal clock triggers; and multiple inputs from sequential channels 
with external and internal clock triggers. The output subroutines include single 
channel output, and dual channel outputs with Z-pulse (intensification) on odd num¬ 
bered channels. 

The ADAHP is atypical in that each subroutine is called directly by a task rather than 
called by 10:. Each subroutine locks the other out until it has finished. The 
general policy of adding 'pauses' between subroutine calls is needed to relinquish 
control to other tasks by the scheduler. 

The supplied tape contains two separate files. The first file contains the six main 
A/D/A subroutines plus several service routines. The second file contains dummy RTX 
routines (SUBX:,SUBR:,DELAY:). This second file must not be linked when creating an 
RTX system. The externally referenced RTX subroutines will be loaded from the RTX 
library. 

Refer to the Analog-Digital-Analog Handler Package User's Manual, 93325-00A0, for a 
de ta i li do sc r i p l ion . 
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SECTION 1 

INTRODUCTION TO COMX 


COMX is a communications executive that is a subsystem of IOX that operates under 
RTX/IOX control. The purpose of COMX is to facilitate the input and output of 
communications information be providing the user with device and protocol independence 
when he writes his programs. (A thorough understanding of RTX and IOX is assumed.) 

Data communications requires far more flexibility than ordinary input/output. Mo 
universal driver is possible because of the variety of available terminals, protocols 
and interface devices and their possible combinations. COMX's two-level driver 
structure provides the needed flexibility. The Protocol Driver maintains the pre¬ 
scribed line protocol and links the computer or terminal with the Device Driver. In 
turn, the Device Driver controls the hardware interface with the communications 
channel. COMX can maintain multiple protocol and device drivers and can link them as 
required, several protocol drivers to a device driver or vice versa, not necessarily 
one to one. 

COMX provides a standard Protocol Driver that implements the IBM Binary Synchronous 
Communications protocol (BiSync) with a standard Device Driver that drives the 
Synchronous Modem Controller (SMC) . However, COMX also allows the user to write his 
own drivers for non-standard protocols and devices. The BiSync protocol interfaces 
with the user's program in a manner compatible with the IOX device-independent 
specifications. 

Although numerous character code sets are used in various protocols, COMX provides 
translation to allow the application program to deal solely with ASCII- The user may 
even provide his own character code set and a table to be used in translation. The 
optional transparent mode permits transmission of data in any bit configuration. 


1.1 HARDWARE 

The hardware required for COMX implementation includes: 

LSI-2 or LSI-3/05 Series computer with a minimum of 8K words of memory to run 
COMX, 16K for development 

The standard interface devices that are supported are: 

Bell 20lC-compatible modem 

Synchronous Modem Controller 53513 or 53617 

Other interface devices an' supported on an optional basis, providing that the user 
writes his own drivers to operate under COMX control. 
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1.2 SOFTWARE 

The required development software includes: 

LSI-2 or LSI-3/05 OS, DOS, FDOS 
MACR02 or MACRO3 assembler 
RTX/IOX/COMX object library 

Tape No. 93300-30 and -31 for LSI-2 
Tape No. 93301-30 and -31 for LSI-3/05 
COMX table(s) (provided by user) 


1.3 PROTOCOL DRIVERS 

When a programmer needs to write his own Protocol Driver for a non-standard protocol, 
COMX provides the facilities for : 

•Causing a line connection to be made - or waiting for an incoming call. 

• Ignoring/reading input data until a prescribed character, or one of a group 
of characters, is received. 

• Transmitting or receiving data and control information until a special 
character, or one of a group of characters, is recognized. 

•Requesting translation of all transmitted or received data from EBCDIC to 
ASCII or the reverse, according to a COMX-supplied table, or to another 
character code set, according to a user-supplied table. 

•Analyzing, reporting and handling a line error status. (When an error 
occurs, the Protocol Driver is notified which, in turn, notifies the 
user's program.) 

•Disconnecting the communications line. 

•Block check calculation and verification with any given polynomial. 


1.4 CIRCUIT CONFIGURATIONS 

COMX allows for control of virtually any line configuration that conforms to a current- 
loop or an RS232-standard convention. Device drivers are capable of driving half¬ 
duplex, full-duplex or simplex modems. Full-duplex operation on the Distributed 
I/O System is supported by connecting two Intelligent Cables in simplex mode, one 
for input and one for output. 


1.5 SYSTEM CONFIGURATIONS 

Protocol Drivers and Device Drivers are designed to accommodate more than one line of 
the same type. Hence, the BiSync standard Protocol Driver can be used to drive as 
many BiSync lines as a given user needs. At System Generation time, the user must 
specify the connections of drivers to lines and devices. Appropriate tables are 
constructed during System Generation to produce these connections. Figure 1-1 
gives the general flow of putting together a program using COMX. 
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Figure 1-1. Flow of Preparing a Program Using COMX 


III/1-3 




ComputerAutomation 


1.6 RELATED DOCUMENTS 


The following documents provide related information: 

LSI-2 Series Minicomputer Handbook Pub. No. 91-20400-00 

LSI-3/05 Software Manual Pub. No. 90-20010-00 

Synchronous Modem Controller Interface 

Description Pub. No. 91-20363-00 

General Information - Binary Synchronous 

Communications IBM Pub. No. GA27-3004 

OS User's Manual Pub. No. 96530-00 

OS Assembler Language (MACR02/3) 

Reference Manual Pub. No. 96552-00 
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SECTION 2 


CONCEPTS OF DATA COMMUNICATIONS 


The purpose of any data communications system is to transfer information from point 
to point. Data communications permits data processing functions to be extended to 
remote locations so that data processing facilities can be used with greater efficiency 
Also, data communications can sometimes substitute for remote data processing equipment 

A data communications system ordinarily consists of at least a sender, a receiver, 
a transmission medium and optional interface equipment (see Figure 2-1). The data is 
sometimes processed, refined, recalculated or recorded, either in transit or entering 
the network. 


INPUT 


OUTPUT 



Figure 2-1. Diagram of Data Communications 

Input/output devices typically are teletype keyboard, CRT, paper tape, magnetic 
tape, card, etc. COMX as a subsystem of RTX/IOX, supports all of these. 

Interface equipment is most commonly a modem. The term "modem" is a contraction of 
"modulator-demodulator." The modem controls the interface between a telephone line, 
or any other form of communications line (analog), and a terminal or computer (digital) 
and does the necessary analog/digital conversion. 

Messages are transmitted via a communications channel which most frequently is the 
public message network (telephone) . The channel can also be a private line, a cable, 
radio, microwave, or ever- just a pair of wires. 


2.1 DATA TRANSMISSION 


The transmission of data can be synchronous or asynchronous. In the former, resynchro¬ 
nization of data on the line is done in intervals of blocks or frames. No start or 
stop bits are transmitted to sychronize individual characters. Incoming data bits are 
counted to form characters; and characters must be consecutive or an idle pattern 
must be transmitted to fill the gaps. ^ 

In asynchronous transmission, re synchronization is accomplished for each character by 
using the character start and stop bits. There may be blank periods between the 
transmission of individual characters in a message. 


I 
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Communications devices and interfaces are either asynchronous or synchronous. Usually, 
devices that operate at slower speeds are asynchronous. Typical applications are 
message switching and interactive time sharing systems. High speed transmission 
(1200 baud or higher) usually is synchronous. High performance communications use 
synchronous transmission to help cut overhead to a minimum. 


2.2 ERROR CHECKING 

Most protocols perform periodic error checking of the data received to ensure communi¬ 
cations integrity. When the ASCII code set is used, an odd-parity check is performed 
on each character. Another form of checking is by a block check character (BCC), a 
form of longitudinal or "column" parity checking. The total bit count is accumulated 
at both the sending and receiving stations during transmission of a block. The 
transmitted BCC is compared with the accumulated BCC at the receiving station for an 
equal condition. In another form of block checking, the BCC is derived from the 
numeric binary value of the message divided by a constant. The quotient is discarded; 
and the remainder is used as the BCC. The receiving station checks its calculated 
remainder with the transmitted remainder for an equal condition. A common BCC is the 
16-bit polynomial Cyclic Redundancy Check (CRC). 


2.3 CIRCUIT CONFIGURATIONS 

The three basic circuit configurations are simplex, half duplex and full duplex. 

Simplex is the simplest. The circuit is arranged to transmit in one direction only. 

In a half-duplex configuration, circuits are arranged to transmit in either direction, 
one way at a time. A full-duplex circuit transmits in both directions simultaneously. 
Both duplex configurations are conversational. 

A channel links two or more communications stations and may encompass multiple circuits. 
However, in writing the application program, the user deals with the channel rather 
than the individual circuits. 


2.4 SYSTEM CONFIGURATIONS 

A variety of system configurations are possible. The two key factors in defining a 
system are: 

If the system is multipoint or point-to-point 
If the system is switched or nonswitched. 

A multipoint system has a central station and multiple tributary stations. Normally, 
this type of system has nonswitched, permanent data links. (A data link is everything 
required to connect two facilities, including interface equipment and transmission 
channel.) The central station selects and polls the tributaries. 

A point-to-point system consists of a communications facility between only two stations 
at a time. With a switched system, there may be multiple stations; but only two can 
be linked at any one time. With a nonswitched system, only two stations a,re involved. 

a switched system, the data link may be freshly established for each transmission 
and may be broken between transmissions. Normally, the data link in a switched 
system is established by manual or computer-controlled dialing procedures using the/ 
telephone as the communications device. ; : 
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Nonswitched systems ahve leased or permanently connected communications lines that 
provide a permanent connection between stations. 


2.5 PROTOCOLS 

Communications protocols are analogous to the protocol used in telephoning. On a 
phone, the idea you wish to communicate ususally is preceded by a "start-of-message" 
phrase such as, "Hello, is Jane there? This is Ed calling." The person you are 
talking with may respond, "Hi. No, Jane is not in. Do you want to leave a message?" 
or, Hi. This is Jane." A phone conversation is ended with, "Goodbye, Jane," and, 
"Goodbye, Ed." 

In a similar manner, a communications protocol may preface data being transmitted 
with a start-of-text (STX) character and terminate the data with an end-of-text (ETX) 
character. The protocol may acknowledge the receipt of data with an acknowledge 
(ACK) character. Also, a protocol can provide header information for addressee/sender 
indentification, message numbering and additional control characters. 


2.6 TRANSMISSION CODES 

A transmission code set consists of graphic characters (numeric, alphabetic and 
special), functional characters and data link control characters. Graphic characters 
are those that can be printed or displayed. Each code provides different capacities 
for total graphics and functional assignments. The two most commonly used codes are: 1 

EBCDEC (Extended Binary Coded Decimal Interchange Code) - 256 assignment 
positions 

ASCII (American Standard Code for Information Interchange) - 128 assignment 

positions 

When either of these code sets is used with the transparent transmission mode, the 
flexibility of the communications system is further increased because all possible 
bit configurations are treated as "data only" within transparent text. Character 
parity checking also is available when transmitting ASCII-coded data. 



V^ode set formats are given in Appendix B. 
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SECTION 3 
CONCEPTS OF COMX 


The basics of COMX are simple. The user writes his program to input and output data 
using calls to the protocol driver via the standard RTX input/output block. COMX 
manages the communication with the Protocol Driver, which formats the data for trans¬ 
mission and provides acknowledgement of received data. The Protocol Driver then 
calls the Device Driver, via RTX/IOX, to transmit the data to the line device (the 
modem controller) in a form acceptable to the transmission channel, translating the 
transmission code first, if necessary. Figure 3-1 diagrams the interrelationships 
between RTX/IOX, COMX and the Protocol and Device Drivers. 

It is quite common for an installation to use a single protocol and Protocol Driver 
for all devices. However, COMX is set up with the flexibility to link Protocol 
Drivers and Device Drivers in any configuration required - one to one or several to 
one. 


3.1 PROTOCOLS 

A commonly used protocol is IBM's Binary Synchronous Communications protocol. This 
is the standard protocol supported by COMX and is referred to as "BiSync" in this 
document. Other protocols may be used with COMX: however, the user will have to 
provide the Protocol Drivers for them. 


3.2 TRANSMISSION CODES 

With COMX, the programmer usually handles data in ASCII format. When necessary, the 
Device Driver then translates the data to EBCDIC for transmission. EBCDIC is the 
code most commonly used with IBM and IBM-compatible communications devices. 
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SECTION 4 
PROTOCOL DRIVERS 


A COMX Protocol Driver is a special kind of IOX driver that is designed to control 
the transmission of data along communications lines. It uses IOX for its control 
so that it may be entered by a standard user call to 10:. It uses some of the normal 
IOX mechanisms and services, but also relies on many of its own. The Protocol Driver 
controls the line by issuing requests to the associated Device Driver. The Device 
Driver performs most of the work, as directed by the Protocol Driver’s requests. 

The associations between application program. Protocol Driver, Device Driver and 
device address are made through the use of Logical Units (LUNs) and Device Information 
Blocks (DIBs). The Unit Assignment Table (UAT) makes the associations. Each Protocol 
Driver is capable of supporting many lines by the use of Controller Information 
Blocks (CIBs) and (DIBs). An application program can be written to work on any 
Protocol Driver; and a Protocol Driver can work on any Device Driver. 


4.1 CLASSES 

I/O function requests modify the control performed by the Protocol Driver. Options 
can be turned on or off and line control can be modified. The exact method in which 
a Protocol Driver handles requests depends on the line control class: demand or 
continuous. A Demand Control Class driver acts only on demand and needs no attention 
between requests. However, a Continuous Control Class driver is in operation con¬ 
tinuously once it has been started, even when it has no specific request to be 
handled. 


Demand Control Class 

In the Demand Control class, reading and writing are done only when the application 
program directs. Only simple line protocols can be implemented within this class 
without placing part of the burden on the application program. A Protocol Driver in 
this class words like a standard IOX driver except for the method of issuing requests 
for I/O operations. The CIB-DIB (Controller Information Block - Device Information 
Block) interlock works like that of the standard IOX. When a request is issued and 
the CIB is available, the driver is entered with the; address of the CIB. The Protocol 
Driver then issues its I/O requests by calling a Protocol Driver Service Subroutine 
that issues I/O requests to the Device Drivers. The Protocol Driver receives control 
back from the subroutine when the I/O operation is complete. After completing all of 
its processing, the Protocol Driver can reissue the I/O request to process the next 
block of data by calling the appropriate service routine, or it can exit to EOR: (IOX 
End-of-Request routine) to complete the user’s request and release the CIB-DIB inter¬ 
lock. The service routines are described later in this section. 
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Cjiitinuous Control Class 
In the Continuous Control class, transmissions over the line take place independent 
of application program requests. Once communication has begun, the Protocol Driver 
is continuously performing I/O in order to retain control of the line. This class is 
used whenever the line protocol requires that each station stay synchronized with the 
control and/or data flow across the line. 

A Protocol Driver can be written to use multiple DIBs per CIB (e.g., an IBM 2780 
terminal with two stations-a CRT and a printer) or only one DIB per CIB (e.g., point- 
to-point circuit). Figure 4-1 diagrams the former case. 



Figure 4-1. Example of Multiple DIB's per CIB 


In the case of multiple DIBs per CIB, the Protocol Driver can poll by following the 
chain of DIBs, polling all that have a READ request pending at the top of the queue. 
Then the Protocol Driver can issue a selection sequence rather than a poll. Sub¬ 
routine CPLCRQ (Protocol Driver Services 1 ) can be used to test the queue for these 
requests. If an acknowledgement to selection or positive response to poll is received, 
then the Protocol Driver may allow IOX to schedule the pending READ or WRITE request 
via the normal IOX mechanisms to initiate this action. This subroutine (CPLCRQ) is the 
main interface with the IOX request scheduling mechanism. The CIB-DIB interlock must 
be kept busy during normal control operations, such as polling, so that the Protocol 

Driver, rather than IOX, can select the DIB/request to process next. 

After determining that a particular pending request is to be processed, the Protocol 

Driver can use the service subroutine CP:EXR to set up the interlocks in the proper 

order to ensure operation. When an operation is complete, the CP:E0R routine can be 
called to complete the request. 

In the case of a single DIB per CIB, the complexity is reduced, but the rules stay 
the same. In other words, the Protocol Driver maintains control of the line until 
time to transmit or receive data. The queue then is checked for the appropriate 
request at top of queue. If found, IOX is allowed to schedule the request as above. 

The request termination procedure also is the same. 

Some protocols (e.g., BiSync) require constant attention on the line looking for 
input, but are not really polling. If a WRITE request is issued by an application 
during this period of time, the Protocol Driver can begin immediately to perform the 
request, assuming that data is not currently being received. To allow the immediate 
processing of the WRITE request from IOX, the CIB-DIB interlock should be left 
raJockod either until the line begins to receive data or until a user request is 
Teeo i.vod. 


1 Subsection 4. \ 
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4..! IH SYNC PROTOCOL DRIVER 

TIk BiSync protocol 1 was designed by IBM to provide reliable half-duplex communica¬ 
tion.''. with high-speed, synchronous modems. The BiSync Protocol Driver implements th< 
following features of the protocol: 

• Insertion and deletion of start-of-text (STX) , end-of-text(ETX) , end-of-bloc< 

(ETB) and/or end-of-intermediate-block (ITB) characters around the message. 

• Line sequencing through enquiry(ENQ), acknowledge (ACK) and end-of-transmiss ion 
(EDT) characters. 

•Acknowledgement of receipt of messages. 

•Cyclic redundancy error checking on text data. 

• Timeouts on line failures. 

•Error recovery via retransmission (retries). 

•A choice of character sets (ASCII or EBCDIC). 

• An optional transparent mode of operation in which every possible bit configura¬ 
tion is valid data. 

• User line control. 

With the BiSync driver, the station may lock the communications line while transmittin 
In Normal Line Control mode (default), the Protocol Driver will lock the line into 
WRITE mode before transmitting user data during a WRITE request. The line is then 
unlocked to other requests after transmission. (This should not be confused with the 
CIB-DIB interlock.) In User Line Control mode, the line is not unlocked after a 
WRITE operation. A sequence of WRITE requests can be issued, the first one locking 
the line into WRITE mode and the last one (identified by the user) unlocking the 
line. A WRITE request issued when the line is already locked by the other station is 
an error and is flagged accordingly. 

No general restrictions are imposed by the BiSync protocol on the length of data 
transmissions. However, a maximum length of 400 bytes is frequently specified by 
many commercially available terminals. As the byte count increases beyond this 
value, block checking is increasingly likely to miss errors, particularly when the 
EBCDIC code set is used. 

Requests issued to the BiSync Protocol Driver are initiated one at a time in priority 
order (by task priority). No simultaneous processing of requests is performed. 

The BiSync protocol is called and its options are selected by the BSC macro which is 
defined in a later section. 2 


1 l-’or detailed information on this protocol, refer to General Information - Binary 

2 Synchronous. Commun i ca lions, IBM Pub. No. GA27-3004. 

Section G.2. 
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,0,4. 3 PROTOCOL DRIVER SERVICES 

Several service routines exist to aid in the writing of Protocol Drivers. These are 
available for all Protocol Drivers. 

The service routines have a great deal in common; concepts, calling and return 
sequences are quite similar. The following conventions are common to all services: 

1. All services are called with the appropriate CIB address in the X register, 
unless otherwise noted. At return, the X register contains the CIB address. 

2. All I/O-oriented requests have an error return and a normal return. The error 
return is in the next location beyond the call. The error status (Protocol Driver 
IOB word 5) is returned in the A register. The normal return is in the next 
location past the error return. 

3. For the several requests that allow for the checking of special characters by 
table comparisons: 

a. A sequence is defined as a single character or two characters (ordered) 
denoting a special meaning in the protocol. 

b. Sequence tables are used for checking data. A sequence table consists of 
contiguous one-word entries. Each word contains a one- or two-character 
sequence (left-justified if one character). 

c. If the table address is zero, no checking is performed. 

Requests are in the form of subroutine calls or macros. Usually, the macros merely 
create the specific subroutine calls. 


CP:SIO (Start I/O) 


The CP:SIO subroutine performs an operation using the IOB in words 1-10 of the CIB. 1 
The logical unit for the I/O operation is obtained from DIB word DLUN, using the DIB 
whose address is in CIB word CPDIB. CP:SIO will return to the IOX scheduler SCH:, if 
necessary (CBOR = 0). 


Calling sequence: 

EXTR CP:SIO 


LDX CIB Address 

JST CP:SIO 

... ERROR RETURN 

. . . NORMAL RETURN 

Return:; with: 


INTERRUPTS - ENABLED 
STATUS - UNCHANGED 
A REGISTER - STATUS, IF 
X REGISTER - UNCHANGED 


ERROR 


’Subsection 4.5 
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Cf’jXLO (Execute I/O ) 

The CP:X10 subroutine performs an I/O operation using the IOB in words 1-10 of the 
CIB. The IOB is set up as requested in the calling sequence. 

In Calling Sequence 1, a control sequence is written from a protocol table. The 
OPCODE must specify a WRITE operation. The TABLE NUMBER parameter specifies which 
table in the Protocol Master Table list is used; and OFFSET specifies the word in 
that table that contains the sequence to be transmitted. 

In Caliing Sequence 2, any I/O operation can be performed. The OFFSET parameter 
specifies the table to be used for stop-character checking; a zero requests no 
chocking. OFFSET is the table position in the Protocol Master Table list. BUFFCR 
ADDRESS and BYTE COUNT can be specified or may be zero, in which case this information 
is taken from the caller’s IOB (found in CBUFF and CRCNT). The BUFFER ADDRESS is a 
byte address. Symbolic opcode definitions can be found in the RTX/IOX/COMX MACROS 
file. 1 

Calling sequence 1: or Calling Sequence 2: 


EXTR 

CP:XI0 

EXTR 

CP:XIO 

LDX 

CIB Address 

LDX 

CIB Address 

LAP 

OFFSET 

LAP 

OFFSET 

JST 

CP:XIO 

JST 

CP:XIO 

DATA 

IOCODE 

DATA 

OPCODE 

DATA 

TABLE NUMBER 

DATA 

0 



BAC 

BUFFER ADDRESS 



DATA 

BYTE COUNT 


followed by: 

. . . ERROR RETURN 

. . . NORMAL RETURN 

Returns with: 

INTERRUPTS - ENABLED 

A REGISTER - TABLE POSITION, IF NORMAL; STATUS, IF ERROR 
X REGISTER - UNCHANGED 



CPREAD (Protocol Driver READ) 

This macro produces a call to CP:XI0 to perform a READ operation. The OFFSET para¬ 
meter specifies a stop-sequence table by position within the Protocol Master Table 
list; a zero denotes no stop-character checking; a -1 denotes that the program already 
has set up the A register to call CP:XI0. 


The various options specify the opcode, buffer address and byte count symbolically. 
The options may be specified in any meaningful combination. Input to the caller’s 
buffer is allowed; lmt no other buffer can bo provided via this macro in which to 
store incoming dal a. Figure 4-2 shows examples. 


Sect ion (>.2 and, in Part I I ol this manual. Section d . 5 
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Q pn though XLAT/ ACHK or CCHK may be specified in the macro call/ the protocol line 
B may not contain specifications for their processing. If the DIB contains a null 
value (zero) for one of these/ no processing will be done, despite any request in the 
calling macro. No error will be indicated in such cases. 

If the Protocol Driver specifies a character timer in the IOB (in clock ticks)/ data 
must be received within that time interval. An error will be indicated if data does 
not appear or continue to appear within that time. 

Calling sequence: 

CPREAD OFFSET[,options[, . .]] 

where options are: 

DELT Delete all incoming data until first unspecified character. 

TEXT Data is text; caller's buffer (from CBUFF and CRCNT) will be used 

to store data. 

ACHK Accumulate checksum (BCC) on incoming data. 

XLAT Translate incoming data prior to storing in buffer. 

CCHK Treat incoming data as checksum (BCC) and check it for validity. 

INIT READ initialization (i.e. r start of new transmission). 

CHK The next data character or sequence received must be a stop 

character. Otherwise/ error status is indicated and the received 
character(s) is returned in IOB word CBUFF. 

This macro returns in the same way as CP:XIO. 


CPREAD STXTBL/INIT 

will check all received characters until a character or 
sequence specified in the STXTBL table is found. Return 
will occur when a proper character or sequence is found 
or when an error occurs. At normal completion/ the table 
position of the received character is returned in the A 
register. 

CPREAD ETXTBL,TEXT r ACHK/XLAT 

will READ, translate and accumulate checksum on each char¬ 
acter received and store each in the caller's buffer 
(CIB word CBUFF) . The request will terminate normally upon 
receipt of a character or sequence contained in ETXTBL. 
Abnormal termination occurs upon expiration of the caller's 
byte count (CTB word CRCNT) or an error. 


Figure 4-2. Examples of CPREAD 
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CPWR IT (Protocol Driver WRITE) 



This macro produces a call to CP:XIO to perform a WRITE operation. Data to be written 
can originate from the caller’s buffer (CIB words CBUFF and CRCNT) or from a protocol 
sequence table. 


The OFFSET parameter serves two functions in this macro call. It specifies the table 
number in the Protocol Master Table list to be used for stop-sequence checking while 
writing from the caller's buffer. Also, it can specify the sequence to be transmitted 
when the data comes from a protocol sequence table. When in the latter mode, protocol 
sequence table 1 is used arbitrarily (i.e. , the table addressed at one word into the 
Protocol Master Table list is the sequence table from which control sequences may be 
transmitted). 

When the OFFSET parameter is used to specify a stop-sequence-checking table, the 
parameter may be: 

0 = no stop checking 

-1 = the A register already has been set up by the program to call CP:XIO 
+n = a positive value giving the stop-sequence-checking table to be used 

The various options specify opcode, buffer address and byte count for the CP:XIO 
call. If an option is specified in the macro call that is not requested in a protocol 
line DIB, processing will not occur and no error will be flagged. Examples of 
CPWRIT are shown in Figure 4-3. 


Calling sequence: 

CPWRIT OFFSET[,option[, . . . ]] 

where options are: 


TEXT Data is text; caller's buffer (from CBUFF and CRCNT) contains the 

data to be transmitted. 

XLAT Translate data prior to transmitting. 

ACHK Accumulate checksum (BCC) on outgoing data. When used in a 

request with ENDS or INTS, this option transmits the accumulated 
checksum after the requested data. 

WCS Write control sequence or control character specified as OFFSET 

into table 1 of the Protocol Master Table list. 


INTS 


HDR 

ENDS 


Intermediate stop specifies that a stop sequence is in process 
without a line turnaround. If ACHK is specified, the accumulated 
checksum is transmitted after completion of the requested WRITE 
operation. 

Write the header, if one is contained in the DIB, ahead of the 
given data. 


Perform an ending stop sequence with a line turnaround. After 
completion of the WRITE operation, the appropriate pad characters 
are transmitted. A line turnaround occurs if required by the 
line being used. If ACHK is specified, the accumulated checksum 
is transmitted prior to pad character transmission. 



This macro returns in the? same way as CP:XIO. 
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CPWRIT STXSEQ,WCS,HDR 

causes the control sequence addressed at STXSEQ in the 
first table in the Protocol Master Table list to be written 
out with a header preceding it. 

CPWRIT SPEC,TEXT,ACHK,XLAT 

causes the caller's buffer (CIB word CBUFF) to be trans¬ 
lated and written to the line. Checksum is accumulated dy¬ 
namically. If any characters or sequences in the data cor¬ 
respond to values in the table of special characters SPEC, 
the request is completed. This usually means that an error 
in the user's data has occurred. 

CPWRIT ETX,WCS,ACHK,ENDS 

causes the control sequence addressed as ETX to be written 
over the line, accumulated into the checksum and followed by 
the proper checksum and pad character sequence. If the pro¬ 
tocol or line is half-duplex, a line turnaround takes place 
after transmission is complete. 


Figure 4-3. Examples of CPWRIT 


CPFUNC (Protocol Driver FUNCTION) 

This macro produces a call to CP:XIO to perform a FUNCTION request. The parameters 
available for each function are described later in this section. 1 

Calling sequence: 

CPFUNC FUNCTION[,parameter[,...]] 
where the functions are: 


LNP 

Set Line Parameters 


SPC 

Set Special Character 


SYN 

Set Sync Character 


INT 

Initialize Line 


ENL 

Enable Line 


DSL 

Disable Line 


RST 

Read Status 


RON 

Raise and/or Wait for Data Set Lines On 

LOF 

Lower and /or Wait for Data 

Set Lines Off 

RVC 

Reverse Channel 


BRK 

Issue Break 


NSY 

Issue New Sync 


RSY 

Reestablish Synchronization 


SDW 

Set Device-Dependent Word 1 


RDW 

Reset Device-Dependent Word 

1 



macro returns in the same way as CP:XIO. 


1 Subsection 4.5, FUNCTION Requests 
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CP :INT (Protocol Request Initialization) 


This subroutine initializes variables upon entry into the driver as necessary to 
perform a Protocol Driver I/O request. It also raises the task priority to CPDPRI 
(:8178), the standard Protocol Driver priority. 


Calling sequence: 


EXTR CP :INT 


label JST CP: INT entry from I/O Scheduler with I/O request. 

to process 


Returns with: 

INTERRUPTS - ENABLED 
A REGISTER - UNDEFINED 
X REGISTER - CIB ADDRESS 


CPsEXR (Execute Request) 

This subroutine causes the appropriate IOX scheduler mechanisms to initiate the I/O 
request at the top of the queue linked from the specified DIB. Return is not immediate. 
Upon return, the IOB is in process and the CIB-DIB interlock is set as requested. 

Calling sequence: 


EXTR 


LDX 

LDA 

JST 

Returns with: 


CP:EXR 


CIB Address 
DIB Address 
CP:EXR 


X REGISTER CONTAINS POINTER TO CIB 
A REGISTER CONTAINS POINTER TO DIB 


INTERRUPTS - ENABLED 

STATUS - UNCHANGED 

A REGISTER - UNDEFINED 

X REGISTER - UNCHANGED 

CIB-DIB INTERLOCK SET AS REQUESTED 


CPsCRQ (Check Request Queue) 

This subroutine checks the IOB queue of pending requests in the DIB. If the top 
entry has the opcode specified, the FOUND return is taken; otherwise, the NOT-FOUND 
return is taken. Upon return, the opcode and modifier fields from the IOB are left 
in the A register in the same format as in the IOB. 
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Calling sequence: 


EXTR 

CP:CRQ 


LDX 

DIB Address 

X REGISTER CONTAINS POINTER TO DIB 

LAP 

OPCODE 


JST 

CP:CRQ 


• • • 


NOT-FOUND RETURN 

• • • 


FOUND RETURN 


Returns with: 


INTERRUPTS - ENABLED 
STATUS ~ UNCHANGED 

A REGISTER - IOB OPCODE, MODIFIER FIELDS 
X REGISTER - UNCHANGED 


CP:EOR (End of Request) 

This subroutine terminates a user's I/O request by BEGINning the IOX EOR: routine. 
Control then is returned with the CIB-DIB interlock left as it was upon entry. 

Calling sequence: 


EXTR 

CP:EOR 


LDX 

CIB Address 

X REGISTER CONTAINS POINTER TO CIB 

JST 

CP:EOR 


Returns with: 




INTERRUPTS - ENABLED 
STATUS - UNCHANGED 
A REGISTER - UNDEFINED 
X REGISTER - UNCHANGED 


CP:ERI (End of Request, Return to Scheduler) 

This subroutine terminates a user's request by BEGINning the IOX EOR: routine, then 
returns to the I/O Scheduler through IORTN:. 

Calling sequence: 


EXTR 

LDX 

JST 



CP:ERI 


CIB Address 
CP:ERL 

d ii rn. 


X REGISTER CONTAINS POINTER TO CIB 
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4.4 INPUT/OUTPUT REQUESTS 

The user's requests for I/O operations are processed by the Protocol Driver. The 
Protocol Driver in turn uses 10: and its own IOB to issue requests, to the Device 
Driver. The three types of I/O requests are READ, WRITE and FUNCTION. The macros in 
the previous subsection (CPREAD, CPWRIT and CPFUNC) can be used to initialize some of 
the words described below. 


Operation Code and Status Word 

Word 5 of the IOB defines the operation requested and, upon return, the status of 
that request. The format of the word is: 

Operation Word 


Bits 

0-1 


2-3 

5 

6 

8-9 


10 

11 

12 

13 


Definition 

Operation code modifier 

READ mod 00 = read characters 
READ mod 01 = delete characters 
READ mod 10 = checksum verify 
WRITE mod 01 = write characters 
Operation code 
00 = READ 
01 = WRITE 
10 = FUNCTION 
Character control 

0 = store characters 
1 = discard characters 
Message type 

0 = control message 
1 = text message 

Operation code transfer modifier 
00 = no modification 
READ mod 01 = initial transfer 
WRITE mod 01 = intermediate transfer 
WRITE mod 11 = ending transfer 
Translate 

Accumulate checksum 
Header requested 

Next character must be a stop character 


Status Word 

Bits Definition 

14 1 = error 

10-13 Error code if bit 14 is set 

0 - lino error (see word CLSTAT in CIB for detailed status) 

1 device unresponsive 

2 invalid checksum 

^ halt l/O occurred 

4 -- invalid I .UN 
! > --- request requested 
(> = input buffer full 
7 - data rejected 
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CLSTAT - Line Status Word 


15 14 19 12 11 10 9 • 7 5 5 4 3 2 1 0 



INPUT ERRORS (7-15) 


OUTPUT ERRORS (0-9) 


TERMINATION ERRORS (3-11) 
Definition 

Transmit data overrun 
Transmit framing error 
Transmit timeout 
Loss of CTS 
Loss of DSR 
Loss of CD 
Special timeout 
Receive timeout 
Receive framing error 
Parity error 
Receive data overrun 


READ Requests 


A READ request is made with an IOB designating: 

Requested Function Code - READ (0) 

Requested Count - Maximum Byte Count for this READ 
Buffer Address - Caller's Buffer Address 
Word 9 - Termination Table Address 

Operation Code Modifier = 00 

The Device Driver processes the READ request by inputting and optionally storing 
characters in the user's buffer, until the requested byte count is satisfied or a 
character or sequence in the termination table is detected. In the latter case, 
the termination character may be stored in the user's buffer; its displacement in 
the termination table is returned in the A register. The actual transfer count 
contains the number of characters stored in the user's buffer. Characters input 
but not stored are not counted. 

Operation Code Modifier =01 

The Device Driver processes the READ request by deleting characters from the Device 
Driver input buffer until a character or sequence in the termination table is not 
detected. This could be used to strip leading blanks or trailing pad characters. 

The actual transfer count contains the number of characters deleted. 

Operation t'odo Modi 1 ioi 10 

Tin- l)cv ire in i v*»r p roc : I In- RKAI> request by reading lli« i block check character (s) 

< jiid v< * r i lying I In • » h< c|:: ;i mi. 


An example oi Hie I OR. lor a KKAI) is shown in Figure 4 - 4 . 
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c 


IOB when 

READ request is 

made 

WORD 

, 

. .... . . 4 

DEFINITION 

4 

400E 

Logical Unit Number of device (:4000 t 14) 

5 

0C40 

READ characters and store into given buffer, 



text message, translate to ASCII, accumulate 



checksum 

6 

0100 

Store up to 256 characters 

7 

2000 

Byte address of user's buffer; buffer starts 



at :1000 

8 

0800 

Byte address of protocol stop-sequence table 

9 

0000 

No protocol modification routine 

10 

012C 

Protocol input character timer of 3 secs 

1 

! 

..i 

| (300 ticks) 

IOB upon 

completion of READ request 

WORD 


DEFINITION 

i 

4 ' 

r j 

' 400E ' 

Unchanged 

5 

0040 

No errors (bits 10-14) 

6 

00D3 

Last character read was 'S' 

7 

2000 

Unchanged 

8 

002A 

Actual count read was 42 characters (bytes) 

9 

0000 

• 

Unchanged 

10 

012C 

Unchanged 


Figure 4-4. Example of I/O READ Request from Protocol Driver to 
Device Driver 
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3 RITE Requests 

* . ' ■ ' ' . , ■ . ' ■ ■ ' ' : . '' : 

A WRITE request is made with an IOB designating: 

Requested Function Code - WRITE (0) 

Requested Count - Maximum Number of Bytes of Data in Buffer 
Buffer Address - Caller's Buffer Address 
Word 9 - Termination Table Address 

The Device Driver processes the WRITE request by transmitting characters from the 
caller's buffer or control character table until the byte count is satisfied or a 
character or sequence in the termination table is detected. In the latter case, the 
termination character(s) is transmitted or not, depending on the state of a flag bit 
in the IOB; and the displacement of the termination character in the termination 
table is returned in the A register. 


FUNCTION Requests 

A FUNCTION request is made with an IOB designating: 

Requested function code - FUNCTION (10) 

Operation modifier - 10 (COMX function) 

Requested count - COMX function code (Table 4-1) 

Information required by the various COMX function codes is stored in the IOB (word 7) 
as required for each function. The two types of function codes are queued and 
immediate. An immediate function code is processed when it is detected, despite any 
other concurrent operation. For example, the function code Halt I/O will be processed 
while a WRITE operation is in progress. Queued functions are processed as they come 
to the top of the queue. The function codes are given in Table 4-1. 


Parameter Word Definitions 


The following functions have parameter words associated with them: 


Code 1 - Set Line Parameters 


Bits 
0 
1 

2-3 

Code 2 - Set Special Character 

1 !> 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


1 

0 

CHARACTER 

1 _ 1 _ L 

--i- -~i- 1 -. J_1 

i - 1 - 1 - 1 - 1 _ 1 _ 1 _ 1 _ 


Definition 

Parity enable 1 = enabled 

Parity select 1 = even 

Word length select 

(modulo 5) 00 = 5 bits, 11 = 8 bits 


Code 3 - Sot Sync Character 



»!> 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


.'. 0. I 

CHARACTER 

l . -1. 1 -J—1—1—1_1_j 

1 _i_1_1_ | _1_1_1_ 
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^ Table 4-1. Function Codes 

CODE FUNCTION 

Invalid 

Set line parameters 
Set special character 
Set synch character 
Initialize line 
Enable line 
Disable line 
Read status 

Raise and/or wait for data set lines on 
Lower and/or wait for data set lines off 
Issue reverse channel 
Issue break 
Issue new sync 

Reestablish line synchronization 
Set device-dependent word 1 
Reset device-dependent word 1 





ITI/4-15 


ComputorAutomation 


Codes 8 and 9 - Raise/On or Lower/Off Data Set Lines 


15 14 13 U 11 10 9 8 7 8 5 4 3 2 1 0 

itt r~o - 

L-i_I—J—j— J _i_ I_ J__i_I_1 a JL— 


WAIT FOR ON OR OFF 


RAISE OR LOWER 


Definition 

Bits 

Definition 

Transmit mode 

8 

Data set ready 

Receive mode 

9 

Clear to send 

Echo mode 

10 

Carrier detect 

Loop-back mode 

11 

Ring indicator 

Data terminal ready 

12 

Signal quality 

Request to send 

13 

Secondary channel 


receive 


Code 14 - Set Device-Dependent Word 1 

Bits Definition 

15 Transmit modification 

14 Transmit transparent mode 

13 Receive transparent mode 

12-0 Device dependent 


4.5 PROTOCOL DRIVER TABLES 

The Protocol Driver requires tables that relate to the protocol driving function and 
tables that relate to the RTX/IOX environment in which it runs. Each line must 
have a Protocol Driver CIB and a Protocol Driver DIB compatible with the equivalent 
ICX tables. Each Protocol Driver must have a set of protocol tables. In the master 
station of a multi-drop line, each terminal should have its own DIB. Details of the 
tables are given in an appendix. 1 

Controller Information Block (CIB) 

The Controller Information Block for the Protocol Driver contains 37 words, most of 
which are standard for IOX. The words that have been changed or added for the COMX 
Protocol Driver are: 

WORD CONTENTS 

20 Protocol Driver Flags 

21 Protocol Master Table Address 

31 DIB Word 8- Protocol Flags 

3 5 To nip o r a ry Storage 

30 Temporary Storage 

_ 37 Length of Protocol CfB - CP8T2H 


Appendix C 
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The flags in Word 20 are defined as: 


Bits 
1 3-15 
10-12 
8-9 
7 
6 
5 
4 
3 

0-2 


D efinition 
NAK Counter 
Invalid ACK Counter 
Timeout Counter 
Inter-Block Flag 
Transparent Mode Flag 
Acknowledgement Flag 
WRITE Request Outstanding 
READ Request Outstanding 
Current Protocol State 



Device Information Block (DIB) 

The Device Information Block for the Protocol Driver contains 29 words, many of which 
are standard for IOX. The words that have been changed or added for the COMX Protocol 
Driver are: 


WORD 

CONTENTS 

7 

Input Char Timer Value 

8 

Protocol Flags 

10 

Device/Protocol-Dependent Flags 

11 

Maximum Block Size 

12 

Line Parameters 

13 

Input Translate Routine Address 

14 

Output Translate Routine Address 

15 

Device LUN 

16 

Line DIB Thread 

17 

Subroutine Return Address 

18 

Temp Cell 1 

19 

Temp Cell 2 

20 

Checksum Routine Address 

21 

Checksum Flags 

22 

Checksum Polynomial 

23 

Checksum Accumulation 

24 

Header Byte Count 

25-29 

Header Bytes 1-10 


The device-dependent and protocol-dependent flags in Word 10 are defined as: 


IS 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


[Hm 

■ 

■ 

■ 

mum 




Protocol-Dependent Device-Dependent 


hits Dofinj_Lion 

]| Disconnect on Wt ito Kile Mark 

If) User I, ino (‘on I ro I 

') A1.1 . WRITES in Tr ans| >a r<n t Mode 

M Un lot mu I l < m I WRITES in Tr an: ;pa r < *n t 

3 Auto-Call this l.ine 

0 Master St.nl.ion 


M< m 1( • 
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o Protocol Master Table 

The Protocol Master Table contains an entry for every protocol table r except DIBs 
and CIBs, that are required for a given Protocol Driver, 


Control Message Table 

The Control Message Table is segmented. Each segment consists of a word giving the 
message length (in words), followed by the message itself. There can be as many 
segments as the Protocol Driver requires. 


Sequence Table 


Sequence Tables hold sequences of control characters that are used by some of the 
Protocol Driver service routines (e.g., CPREAD, CPWRIT). Word 0 of the Sequence Table 
contains flags and the number of contiguous one-word entries following it in the table 
Each entry word contains a left-justified, one-character sequence or a two-character 
sequence. In the example shown in Figure 4-5, the first two entries have only one 
character; the remaining one has two. 


WORD 

BITS 15-8 

BITS 7-0 

CONTENTS 

0 

FLAGS 

3 

Flags and Number of Entries 

1 

ElCl 

0 

Entry 1, Character 1 

2 

E2C1 

0 

Entry 2, Character 1 

3 

E3C1 

E3C2 

Entry 3, Characters 1 & 2 


Figure 4-5. Example of a Sequence Table 


The flags are defined as: 

Bits Definition 

15 Reserved for use by the Device Driver. 

14 Error - the first character of a two-character sequence is found, 

but the second does not immediately follow. 

13 Error - the next character is not a character sequence in the table. 

12 Error - a character sequence in the table is found. 

11 Transfer (store) character sequence found. 

10 Accumulate checksum on character sequence found. 

9,8 Undefined. 


Ci 
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SBCTION 5 
DEVICE DRIVERS 


A COMX Device Driver is a set of routines running as a driver under IOX, designed to 
transmit and receive data over a communications line. A COMX Device Driver has more 
capability than an IOX driver. As directed by the Protocol Driver/ the Device Driver 
actually controls most activity on the line. 

Certain limitations (device-dependent considerations) exist due to the characteristics 
of the lines/ protocols/ controllers/ etc. For example, the BiSync protocol cannot 
be run on an asynchronous device; and an asynchronous modem cannot be run on an SMC 
(Computer Automation's Synchronous Modem Controller). 


5.1 SYNCHRONOUS MODEM CONTROLLER DEVICE DRIVER AND ROUTINES 

Computer Automation's Synchronous Modem Controller (SMC) interfaces only with synchro¬ 
nous modems. The SMC device handler, which is the standard device handler in COMX, 
controls most of the activity on the communications channel, as directed by the 
Protocol Driver. Like any user-written Device handler, the SMC device handler 
consists of several device-dependent routines called by the COMX Device Driver. The 
functions of these routines are described below. 


Set Line Parameter 

When applicable to the device, this routine presents the device with the given line 
parameter word. 

Called by: 

CD:LNP COMX Device Driver Line Parameter Subroutine 
Calling sequence: 

LDA line-parameter-word (defined under CD:FLP function 1 ) 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

... ERROR RETURN 

. . . NORMAL RETURN 


1 Subsection 5.3 
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Set Sync Character 

When applicable to the device, this routine presents the device with the synchroniza¬ 
tion character from the Line Information Block (LIB). 

Called by: 

CD:SYN COMX Device Driver Sync Character Subroutine 
Calling sequence: 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 


Set Special Character 


When applicable to the device, this routine presents the device with the special 
character from the LIB. 


Called by: 

CD:SPC COMX Device Driver Special Character Subroutine 


Calling sequence: 


JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 


Initialize Line 

This routine initializes and/or resets the device and line, as necessary. 
Called by: 

CD:INT COMX Device Driver Initialization Subroutine 
Calling sequence: 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 
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This routine does whatever is necessary to enable the communications line through the 
device (e.g., raise DTR). 

Called by: 

CD:ENL COMX Device Driver Enable Line Subroutine 


Calling sequence: 


DEVDEP CALL DEV-DEPENDENT ROUTINE 
ERROR RETURN 
NORMAL RETURN 


Disable Line 

This routine does whatever is necessary to disable/disconnect the communications line 
(e.g., drop DTR). 

Called by: 

CD:DSL COMX Device Driver Disable Line Subroutine 
Calling sequence: 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

... NORMAL RETURN 


Start Input 


This routine does whatever is necessary for the device to begin inputting data 
(e.g., raise Receive Mode). 

Called by: 

CD:STI COMX Device Driver Start Input Subroutine 

Calling sequence: 

JST BEGIN: START A TASK 

DATA DEVDEP START INPUT ROUTINE ADDRESS 

DATA STIPRI START INPUT PRIORITY 


(Error Exit) 
JST 
DATA 
DATA 


BEGIN: START A TASK 

CD:IER INPUT ERRPR ROUTINE 

CRPPRI+1 ERROR PRIORITY (from PRIORITY = C2IPRI) 


(Normal Exit after EOB Occurs) 

JST CD:SRP SCHEDULE RECEIVE PROCEDURE 
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01 


f f Stop Input 

This routine does whatever is necessary for the device to stop inputting data. 
Called by: 

CD:SPI COMX Device Driver Stop Input Subroutine 


Calling sequence: 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 


Start Output 

This routine does whatever is necessary for the device to start outputting data 
(e.g., raise Transmit Mode and RTS). 


Called by: 

CD:STO COMX Device Driver Start Output Subroutine 


Calling sequence: 


JST 

DATA 

DATA 


BEGIN: START A TASK 

DEVDEP START OUTPUT ROUTINE ADDRESS 

STOPRI START OUTPUT PRIORITY 





(Error Exit) 
JST 
DATA 
DATA 


BEGIN: START A TASK 

CD:OER OUTPUT ERROR ROUTINE 

CTLPRI ERROR PRIORITY 


(Normal Exit 
JST 
DATA 
DATA 


after EOB Occurs) 

BEGIN: START A TASK (usually done by INTQs) 

CD:DEX OUTPUT EOB EXIT ROUTINE 

CINPRI INTERRUPT HANDLER PRIORITY 


Stop Output 

This routine does whatever is necessary for the device to stop outputting data. 
Cal led by: 

CI):SP() COMX Di'vbe Dr iver Slop Output Subroutine 


I 

* 

i 
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Calling sequence: 


DEVDEP CALL DEV-DEPENDENT ROUTINE 
ERROR RETURN 
NORMAL RETURN 


Input Character Processor 1 

This routine is called for each character input (READ, Modifier = 00) after the 
protocol modification routine has been executed and before the stop-character 
check, checksumming or translation is done. 

Called by: 

CD:RVP COMX Device Driver Receive Processor 
Calling sequence: 

LDA CHAR (loads into the low-order bits 7-0) 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . IGNORE RETURN, GET NEXT RETURN 

. . . NORMAL RETURN (current character is updated 

with character returned in A register) 


Input Character Processor 2 

This routine is called for each character that is input (READ, Modifier = 01) after 
the protocol modification routine has been executed and before the stop-character 
check or checksumming has been done. 

Called by: 

CD:RVP COMX Device Driver Receive Processor 
Ciilling sequence: 


DEVDEP CALL DEV-DEPENDENT ROUTINE 
ERROR RETURN 

IGNORE RETURN, GET NEXT CHAR 

NORMAL RETURN (current character is updated 

with character returned in the A register) 


Output Charact e r Processor 1 

This, rouLino is called for each character output (WRITE) after the translation and 
the protocol modification routines have been done, and before stop-character check 
ar id c h e ok s u mm inq . 

Called by: 

CD:DTP COMX Device Driver Data Transmit Procedure 
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Calling sequence: 


LDA CHAR 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . IGNORE RETURN, GET NEXT CHAR 

. . . NORMAL RETURN (current character updated 

with character returned to A register) 


Raises and/or Wait for Data Set Signals On 

This routine does whatever is necessary for the device to raise the given signal (s) 
and/or wait for data set signal(s) to come on, then return. 

Called by: 

CD:RON COMX Device Driver Raise and/or Wait for Data Set Signal on 

Subroutine 

Calling sequence: 

LDA parameter-word (described under the CD:FRN function 1 ) 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 


Lower and/or Wait for Data Set Signals Off 

This routine does whatever is necessary for the device to lower the given signal (s) 
and/or wait for the data set signal(s) to go off, then return. 

Called by: 

CD:LOF COMX Device Driver Lower and/or Wait for Data Set Signals Off 

Subroutine 

Calling sequence: 

LDA parameter-word (described under CD:LOF function 1 ) 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 


Resynchronize Line 

When applicable, this routine does whatever is necessary for the device to reestablish 
synchronization. 


Called 


by: 


CD:RSY COMX Device Driver Resync Line Subroutine 

Subsection 5.3 
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Calling sequence: 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 


Issue New Synchronization 

When applicable to the device, this routine does whatever is necessary for the device 
to send a new sync pulse (also called quick sync) over the line. 

Called by: 

CD:NSY COMX Device Driver New Sync Subroutine 
Calling sequence: 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 


Issue Break 

When applicable to the device, this routine does whatever is necessary for the device 
to send a break over the line. 

Called by: 

Calling routine non-existent; ASYNCH only 
Calling sequence: 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 


Reverse Channel 

When applicable to the device, this routine does whatever is necessary for the device 
to be in a reverse-channel mode. 

Called by: 

Calling routine non-existent; ASYNCH only 
Calling sequence: 

JST DEVDEP CALL DEV-DEPENDENT ROUTINE 

. . . ERROR RETURN 

. . . NORMAL RETURN 
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Miine Transmit Procedure 


This routine does whatever is necessary (e.g., start output, turn line around) to 

transmit the data prepared by the COMX Data Transmit Procedure over the line. 

Called by: 

CD:DTP COMX Device Driver Data Transmit Procedure 

Calling sequence: 

JST BEGIN: START A TASK 

DATA DEVDEP CALL DEV-DEPENDENT ROUTINE 

DATA CLTPRI LINE TRANSMIT PRIORITY 



On error or normal return, return to CD:WRX (COMX Device Driver WRITE Request Exit) 
with the request status (STATUS in CIB) set accordingly. 

5.2 DEVICE DRIVER SERVICES 

Several service routines are provided to aid in the writing of device-dependent 
routines. The services are described below. 

CD:IER (Input Error) 

This common input error service combines the given status with the existing line 
status (CLSTST) and checks for termination errors. If termination errors have not 
occurred, CD:IER will end and allow the receive procedure to continue. If termination 
errors have occurred, CD:IER stops input on the line, then checks for loss of DSR 
(data set ready). If DSR is lost, CD:IER also disables the line. The receive 
procedure is scheduled to end the request. 

Calling sequence: 

LDX input-CIB-address 

LDA error-status 


followed by: 
JST 


BEGIN: 

CD:IER,CRPPRI+1 


or, if operating at CRPPRI+1 
JMP CD:IER 


Returns with: 


Does not return 
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Cl):< >I;R (On t put E r ror) 

r l'l i i: > common out-put error service combines the given status with the existing line 
status (CI.STST) and checks for termination errors. If no termination errors have 
occurred, CD:OER ends and allows the transmission to complete. If transmission 
errors have occurred, CD:OER stops output on the line, then checks for loss of DSK 
(data set ready) . If DSR is lost, CD:OER also disables the line. The A register is 
loaded with the line status, and control is returned to the output initiator (the 
CD : STO caller). 

Calling sequence: 

LDX output-CIB-address 

LDA error-status 


followed by: 
JST 


BEGIN: 

CD:OER,CLTP RI 


or, if operating at CLTPRI: 
JMP CD:OER 


Returns with: 


Does not return 


CD :OEX (Output EOB Interrupt Exit) 


This common output end-of-block service cancels the deadman timer, clears output 
active in the line software status, and returns to the output initiator (the CD:STO 
caller). 


Calling sequence: 


output-EOB-interrupt-routine-address 


followed by: 
JST 


BEGIN: 

CD:OEX,CLTPRI 


or, if operating at CLTPRI*. 
JMP CD:OEX 


Returns with: 


A REGISTER - ZERO 
X REGISTER - OUTPUT CIB ADDRESS 


CD:IFN (Issue Function) 


This service gets the device address from the Line Information Block (LIB), combines 
it with the given instruction, then executes it with the given A register. An example 
is given in Figure 5-1. 
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Calling sequence: 

LDX LIB address 

LDA desired A register when function is issued 

SIN 3 

JST CD:IFN 

. . • 0,FC INSTRUCTION AND FUNCTION CODE 

. . . RETURN , SIN IN EFFECT FOR 1 INSTRUCTION 

Returns with: 



Figure 5-1. Example of CD:IFN 


CD:NOP (NOP) 

This service simply returns. It can be used in the Device-Dependent-Routine Table 
when no function needs to be performed. 


CD:NCP (NOP Character Processor) 

This service simply takes the normal return. It can be used in the Device-Dependent 
Routine Table when no function needs to be performed in a character processor. 

• ••••••• # 

Unless otherwise stated, the following services have the following calling sequences 

LDX LIB-address 

JST CD:xxx 

. . . RETURN 

All of these services call the appropriate device-dependent service to perform the 
particular function for the device. Additional operations are noted. 

CD:LNP (Set Line Parameters) 

Line parameters are defined in the DIB. They include word length parity selection 
and enable. 

CD:SYN (Set Sync Charact er) 

CD : SP C (Se t S pec La Character) 

CD:INT (Initialize Lino) 
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CD;ENL (Enable Line) 

This service sets line enabled in the line software status. 

CD:DSL (Disable Line) 

This service resets line enabled in the line software status. 


CD:STI (Start Input) 

This service sets input active in the line software status, sets Auto-I/O byte count 
to -1, primes the current character address for the Receive Procedure (CD:RVP), 
and stores the input buffer address in the Auto-I/O instruction. It returns 
immediately to the caller. The error return is to CD:IER (Interrupt Error Routine); 
the completion return is to CD:SRP (Schedule Receive Procedure). 


CD:SPI (Stop Input) 

This service cancels the input timer, clears the Auto-I/O byte count and buffer 
address, and resets input active in the software line status. 


CD:STO (Start Output) 

This service saves the return address in the CIB, sets output active in the software 
line status, sets byte count and buffer address from the LIB into the Auto-I/O 
instruction, and starts a deadman timer. If completion is normal, the A register 
contains a zero; if an error, the A register contains the line error status. 


CD:SPO (Stop Output) 

This service cancels the output timer and resets output active in the software line 
status. 

CD:NSY (Issue New Sync) 


CD:RSY (Re synchronize Line) 

5.3 I/O REQUEST HANDLING 

Three types of requests control the functions of the Device Driver: READ, WRITE and 
FUNCTION requests. These requests are made by the Protocol Driver to the Device 
Driver, as detailed in Section 4.4. The Device Driver processing is detailed below. 
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READ Request Processing 

The function of a READ request is to input data to the protocol for passage to the 
user. This is independent of the actual reading of data from the communications 
line. The line will be actively reading data either all the time or only when trans¬ 
mission is active. Data will be buffered by the Device Driver, if necessary. The 
driver, of course, will wait for data as necessary when processing a READ request. 

The READ request received by the Device Driver from the Protocol Driver commands the 
usage of received data. Based on previously set parameters 1 , the Device Driver will 
locate control information, transmit data to the destination buffer, translate the 
data, establish timeouts and detect errors. The parameters controlling these opera¬ 
tions are provided in the protocol tables 2 , in previously issued functions and in the 
READ IOB. 


WRITE Request Processing 


The function of the WRITE request is to transmit data supplied by the Protocol Driver 
over the communications line. Each WRITE request contains part or all of a message. 

In accordance with previously set parameters 1 , the Device Driver will locate control 
information, transmit data characters over the communications line, translate the 
data, recognize the end of a message and turn the line around. The parameters control¬ 
ling these operations are provided in the protocol tables, in the previously issued 
functions and in the WRITE IOB. 

Due to line timing constraints, it is sometimes necessary for the device handler to 
assemble an entire message prior to transmission of any part of it. The Device 
Driver will complete each WRITE request by performing any specified processing (e.g., 
translation) and moving the data to the device buffer. When the final WRITE request 
(end of message) is issued, the device handler will transmit over the communications 
line. 


FUNCTION Request Processing 

FUNCTION requests control the state of various parameters of the communications line. 
They are used to affect hardware control of the line and to command the device handler 
(or the hardware) to perform certain protocol-related functions. The two kinds of 
functions are queued and immediate. Queued functions are performed as they rise to 
the top of the queue. Immediate functions are performed as soon as they are issued. 


5.4 DEVICE DRIVER TABLES 

The Device Driver requires a table that lists the addresses of all of the device¬ 
dependent routines, an input CIB for each device, an output CIB for devices attached 
to full-duplex lines, an output EOB routine for devices attached to half-duplex 
lines, and a Line Information Block (LIB) for each line. Details of these tables are 
given in tin appendix. 3 


Subsection 6.1 
2 Subsection 4.6 
3 Appendix C 
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Device-Dependent-Routine Table 

Each device handler must have a Device-Dependent-Routine Table. This table contains 
the addresses of the routines that handle device-unique procedures. The user must 
prepare these routines himself when writing a device handler. The table is formatted 
as follows: 


WORD 


ROUTINE ADDRESS 


0 Reserved 

1 Set Line Parameter 

2 Set Sync Character 

3 Set Special Character 

4 Initialize Line 

5 Enable Line 

6 Disable Line 

7 Start Input 

8 Stop Input 

9 Start Output 

10 Stop Output 

11 Input Character Processor 1 

12 Input Character Processor 2 

13 Output Character Processor 1 

14 Output Character Processor 2 

15 Raise and/or Wait for Data Set Signals On 

16 Lower and/or Wait for Data Set Signals Off 

17 Resync Line 

18 Issue New Sync 

19 Issue Break 

20 Reverse Channel 

21 Line Transmit Procedure 

These routines are described in an earlier part of this section. 1 


Controller Information Block (CIB) 

For a half-duplex line, the Device Driver needs only one CIB. The same CIB is used 
for both input and output processing because input and output are not concurrent. 
However, a separate output end-of-block interrupt routine is needed. This consists 
of words 1-14 of an output CIB. 

For a full-duplex line, both an input and an output CIB are *required. 


Subsection 5.2 
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^Many of the CIB entries are standard for IOX. The entries added for COMX are: 


WORD 


CONTENTS 


0 Beginning of Request Flag/Input or Output End-of-Block Interrupt 

Address 

1-12 Input or Output End-of-Block Interrupt Routine 

13 Timer/Interrupt State Flag 

14 Line Information Block Address 

20 Input Interrupt Routine Address 

21 Device Driver Subroutine Return Address 

23 Line Error Status 

33 Return Address for Device Driver Start Output Routine 

34 Device CIB Chain 

35 Current Character Address 

36 Current Character(s) 

37-38 Temporary Cells 

39 Stop Table Flags 

40 Translate Routine Address from Caller's DIB 

41 A Register Returned to Caller at EOR 

42 Current Interrupt Buffer Address 

43 Additional Interrupt Byte Count 

44 Character Bit Mask 

45 Length of Input/Output CIB 

The Line Error Status in word 23 is defined as follows: 

Bits Definition 

0 Transmit data overrun 

3 Transmit framing error/break detect 

5 Transmit timeout 

6 Loss of clear to send 

7 Loss of data set ready 

8 Loss of carrier detect 

9 Special timeout 

10 Receive timeout 

12 Receive framing error/invalid stop character 

14 Parity error 

15 Receive data overrun 

The Stop Sequence Table flags in word 39 are defined as follows: 

Bits Definition 

0-7 Table count 

10 Accumulate checksum on stop character(s) 

11 Transfer stop char(s) (READ-store, WRITE-transmit) 

12 Error if .stop character not found 

13 Error if current char is not stop char 

14 Error if 1 i rst I omul and pair is not; a s.lop condition 

1 5 First s t op v *h< i rael < * r ft >nnd 


III/5-14 



m- 


Line Information Block (LIB) 

The Device Driver requires a Line Information Block to define each communications 
line attached to the device. The LIB is not standard for IOX? it serves only COMX 
The contents of the LIB are: 


WORD CONTENTS 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 
27 


Standard Line Status Word 

Software Line Status 

Device Address 

Device Driver Flags 

Device Transfer Vector 

Input CIB Address 

Output CIB Address 

Output EOB Interrupt Rtne Address 

Input Word Interrupt Location 

Output Word Interrupt Location 

Start Input Instruction 

Input Interrupt Buffer Start Addr. 

Input Interrupt Buffer End Addr. 

Output Device Buffer Address 
Output Interrupt Buffer Addr. 

Output Interrupt Byte Count 

Function Proc. Current CIB 

Function Proc. Next CIB 

Last Function Issued 

Last Hardware Status Word 

Current Line Parameter Word 

Line (Modem) Signal Delay 

Device-Dependent Word 1 

Device-Dependent Word 2 

Device-Dependent Word 3 

Pad Character Information 

SMC Sync/Special Character 

Exception Interrupt Point of Interrupt 


The Standard Line Status in word 0 is defined as follows: 


Bits 

0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 
I l 
1 2 
13 


Definition 

Data set ready 

Clear to send 

Carrier detect 

Ring indicator 

Signal quality 

Secondary channel receive 

Transmit framing error 

Receive framing error 

Parity error 

Trainimit data overrun 

Receive data overrun 

Secondary chnnnoJ receive 

Da La ready 

Transm.i.t to r emp ty 
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The Software Line Status in word 1 is defined as follows: 

Bits Definition 

0 Transmit mode/output active 

1 Receive mode/input active 

2 Echo mode 

3 Loop back mode 

4 Protocol duplex 

5 Line duplex 

6 Modem/controiler type 

7 Answer mode 

8 Carrier type 

Bits Definition 

9 Carrier detect must be lowered before request to send is raised 

12-13 Line code set 

14 Line enabled 

15 Line initialized 

The Pad Character Information in word 25 is defined as follows: 

Definition 

Number of pad chars to be sent 
The character to be sent 


Bits 

0-7 

8-15 
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SECTION 6 
SYSTEM GENERATION 


In communications systems, there are an infinite variety of possible combinations of 
protocols, code sets, devices and lines. Even when the standard protocol and device 
are used, the options are numerous. Therefore, the tables must be supplied by the 
user. COMX tables also reference the object modules required to support the desired 
configuration. During loading (or Link Edit) these references call the modules to be 
included in the load. 

The tables that must be supplied by the user include those for the protocol and any 
non-standard translation as well as the device, controller and line information 
blocks (DIBs, CIBs and LIBs) . In addition, the user has the normal IOX control over 
the Unit Assignment Table (UAT) . 

COMX System Generation is in two phases: 1) the assembly of the tables, and 2) the 
load phase which is identical to that performed under RTX/IOX. The tables can be 
generated from the macros described in this section and assembled with the MACR02 or 
MACRO3 assembler. Alternately, the user can build his own tables according to the 
required format and content presented in another section. 1 

6.1 TABLE REQUIREMENTS 

The tables required for COMX System Generation are dependent on the number of communi¬ 
cation lines and the protocol and line configurations. The table requirements are: 

Protocol Driver Tables 

1 set of protocol tables per driver 

translation tables for nonstandard code sets (other than ASCII or EBCDIC) 
for half-duplex protocol 
1 CIB per line 

1 DIB per line 

for full-duplex protocol 

2 CIBs per line 
2 DIBs per line 

Device Driver Tables 
for half-duplex line 

1 full input CIB per line 
1 partial output CIB per line 
1 DIB per line 
1 LIB per line 

for full-duplex line 

1 full input CIB per line 
1 full output CIB per line 
1 input DIB per line 
1 output DIB per line 
1 LIB per line 

1 Subsection 4.6 and 5.4 
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6.2 TABLE-GENERATING MACROS 

The macros described below work in combination to generate all of the tables required 
for a communications line. Figure 6-1 shows an example of the use of the table¬ 
generating macros. The macro source file on paper tape is supplied with RTX. The 
file listing is shown in Part II, Subsection 3.3, of this manual. 

To process a line, the user first must specify the protocol, device and line configura 
tions and then generate the tables. The DEVICE macro is used to set up all device- 
related and line-related parameters. A protocol driver designating macro (BSC for 
the standard BiSync) is used to set up all protocol-related parameters. Once speci¬ 
fied, device, header, line and protocol parameters can be left unchanged for the 
generation of several sets of line tables. A CLINE macro is used to generate the set 
of tables based on these parameters. The CLINE macro has the ability to override 
certain device and line parmeters that were previously supplied. The NAMDEF macro 
performs initialization and must precede any other macro in the assembly. 


The NAMDEF Macro 

This macro generates NAM directives at the beginning of the module and initially 
defines all necessary symbols for use of subsequent macro processing. The form is: 

NAMDEF [dib-namel[,dib-name2[,...]]] 

where: dib-namel A four-character DIB name that the user will use in a 

subsequent CLINE macro. 


NAMDEF PDOO,DDOO 

BSC 400,EBCDIC,XLATE,DISCON 

HEADER 6,:32,:32,:32,:32,:32,:32 

DEVICE 513 

CLINE PDOO,12,DDOO,:D,:A0,8,2400 

This set of macro calls will generate the Protocol DIB 
(D:PDOO) and CIB and the Device Driver DIB (D:DD00), 

CIB and LIB. The BiSync Protocol Handler will be loaded. 
The maximum transmission size is 400 characters. The 
line code is EBCDIC; and translation will be done so 
that the user will deal with ASCII. Whenever a Write 
File Mark is issued, the Protocol Handler will disconnect 
the line. The header consists of six sync characters 
(:32 in EBCDIC). The device being used is the Synchron¬ 
ous Modem Controller 53513. The device address is :0; 
and the interrupt address starts at :A0. The line is a 
synchronous, half-duplex, switched line (line type 8) 
with a speed of 2400 BPS. 


Figure 6-1. Example of Using Table-Generating Macros 
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Every Device Information Block (DIB) name used in the module being assembled must be 
specified in a NAMDEF macro. As many names as can be typed prior to column 72 car 
be placed on each NAMDEF; and as many NAMDEFs can be used as are required; but all 
must appear prior to the first statement that generates code. The macro will con¬ 
catenate a prefix of "D:" to each DIB name specified. The user can write NAM state¬ 
ments for the DIB names and prefix each with a "D:", or he can use NAM statements to 
declare other entry names; but at least one NAMDEF macro must be present to define' 
the symbols necessary for macro processing even if the NAMDEF has no operands. 


The DEVICE Macro 


This macro describes the kind of device being used, its address and any options on 
it. The form is: 


DEVICE device-type[,line-id[,speed[,device-address,interrupt-address[, 
options[,. . .]]]]] 


where: device-type 


The last three digits of the CA controller part number; 
for SMC, use 513 or 617. 


line-identifier The id of the communications line and modem configura¬ 

tion; Table 6-1 lists all possible line identifiers; it 
will be 4 or 8 for the standard COMX. 


speed The line speed expressed in Baud rate, 

device-address The device's (SMC's) address. 


interrupt-address The device's (SMC's) first or main interrupt address 

(same as the address used to strap the controller). 


options are: 

CONSTC CONSTant Carrier. On a line so specified, the carrier 

will be held on during I/O. On a synchronous full- 
duplex line (line-id 3 or 7) that is being used in a 
half-duplex manner, setting CONSTC will cause COMX to 
output continuous sync characters during input opera¬ 
tions. This also assumes that the terminal does the 
same (i.e., the line is always in sync in both 
directions). 


WAITCO WAIT for Carrier Off. This causes COMX to complete 

each input message by waiting for carrier detect to go 
off prior to transmitting the message. This is useful 
on half-duplex modems that present clear-to-send too 
earLy (e.g., ITT Synchronous Modems). 

A DEVICE macro must bo issued prior to any CLINE macros, defining lines connected to a 
particular device. Each M.iNE i ssued after; a given DEVICE macro will generate Device 
CIPj and DIB fables for that device. 'Ibis specification can be overridden by a 
subsequent DEVICE macro. 
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Table 6-1. Line Identification 


Line 

Identifier 

Duplex 

Modem 

Type 

Line 

Type 

RS—232 
Compatible 

Compatible BELL System 
Modem (examples only) 

o 

Full 

None-Current Loop 

Dedicated 

NO 

None 


Full 

Async 

Dedicated 

Yes 

103/113 Series 


Half 

Async 

Dedicated 

Yes 

202D/202T 


Full 

Synchronous 

Dedicated 

Yes 

201B/208A/201C 

4 

Half 

Synchronous 

Dedicated 

Yes 

201B/208A/201C 

- 

Full 

Async 

Switched 

Yes 

102/113 Series 

£ 

Half 

Async 

Switched 

Yes 

202C/202S 

- 

Full 

Synchronous 

Switched 

Yes 

CODEX LSI 48D 

■ 

Half 

Synchronous 

Switched 

Yes 

201A/208B/201C 
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The line-identifier, device-address, and interrupt-address parameters are optional 
since they can also be specified on a CLINE macro. The line-identifier parameter 
must be specified on one of the two macros. The device-address and interrupt-address 
parameters will default, if not specified, to the COMX standard addresses for that 
device-type. Any parameters specified must be in the proper operand position on the 
line; i.e., the proper number of commas, if any, must precede a specified parameter 
if some parameters are omitted. 

Appropriate EXTR statements are produced to cause loading of the Device Driver 
denoted by the type parameter. 


The CLUN Macro 


This macro generates a 16-bit Logical Unit Name/Number according to the standard 
naming convention used in COMX for the interface between the Protocol Driver and the 
Device Driver. The CLUN macro adds 16384 (:4000) to the lun parameter, creating a 
COMX standard LUN. This sum is used as the operand of a DATA statement. This macro 
is used by the CLINE macro. 

The macro format is: 

CLUN lun 

where: lun The LUN number (<16384). 


The BSC Macro 

This macro designates the line as being attached to a Binary Synchronous Communica¬ 
tions Protocol Driver. It is issued prior to the CLINE macros defining BSC lines. 
Each CLINE after a BSC macro generates a BSC Protocol Driver CIB and DIB. A sub¬ 
sequent Protocol-Driver-designating macro will override this. 

Issuance of this macro causes the BSC Protocol Driver modules, the BSC Protocol 
Tables and a translate table (if requested) to be declared in EXTR statements and, 
thus, be included in the final load. 

The macro format is: 

BSC max-msq-size , char-set [, options [, . . .]] 

where: max-msg-size The size of the largest message transmitted or received 

over the line (in bytes). 

char-set Either ASCII or EBCDIC; also selects the block check 

character (BCC) sequence for error checking. 
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Options; 
XLATE 


Selects auto-translation when character set is EBCDIC, 
allowing all user data to be in ASCII. 


XPRNT 

UXPRNT 

ULC 


Selects Transparent Mode for all WRITES; a FUNCTION 
request can change this. 

Selects Transparent Mode only for Unformatted WRITE 
requests? a FUNCTION request can change this option. 

User line control to transmit a sequence of WRITES at 
one time. 


DISCON 


Disconnect on File Mark. 


SLAVE 


Slave Mode; default is Master Mode. 


The HEADER Macro 


This macro defines a one-to-ten character header to be used on transmitted messages. 
When using the SMC (either 513 or 617) and transmitting in ASCII, the bit positions 
8-0 in the character must be reversed (0-8). For example, :16 should appear as :68, 
and :C4 should be :23. 

The macro format is: 

HEADER count,char-l [, char-2 . . .[, char-10 ]] 

where: count The number of characters (1-10) in the header. 

char-1 ( -10) The nth character in the heading. 

The HEADER macro must be used in conjunction with the BSC macro to define the leading 
synchronization characters on a message. The suggested form is: 

HEADER 4,:32,:32,:32,:32,:32,:32 for EBCDIC 

HEADER 4,:68,:68,:68,:68,:68 f :68 for ASCII 


The CLINE Macro 


This macro provides the basic definition of a communications line. It generates 
the Line Information Block (LIB) and the basic CIBs and DIBs for a line. 

On a half-duplex line, the tables generated are: 

1 Device Driver input CIB 
1 partial Device Driver output CIB 
1 Device Driver DIB 
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On a full-duplex line, the tables generated are: 

1 Device Driver input CIB 

1 Device Driver output CIB 

1 Device Driver input DIB 

1 Device Driver output DIB 

For a half-duplex protocol, the tables generated are: 

1 Protocol Driver CIB 

1 Protocol Driver DIB 

For a full-duplex protocol, the tables generated are: 

2 Protocol Driver CIBs 

2 Protocol Driver DIBs 

The Device Driver tables are chosen according to the specification in the preceding 
DEVICE macro. The Protocol Driver tables are generated according to the specifica¬ 
tion in the preceding BSC macro. If the device address and interrupt address para¬ 
meters are not supplied in the CLINE macro, they are obtained from the preceding 
DEVICE macro or are defaulted. 

The macro format is: 

CLINE dib-namel , device-LUN , dib-name2 [, dev-address , int-address [, line-id 

[, speed [, options [, . . .]]]]] 

where: dib-namel The name given to the Protocol Driver DIB for the line, 

specified as four characters. 

dev-LUN The Logical Unit Name/Number (LUN) to which the Protocol 

Driver CIB will be connected. In the UAT, the user must 
assign this LUN to dib-name2 (see below). 

dib-name2 The name given to the Device Driver DIB for the line, 

specified as four characters. 

dev-address The device's (controller's) address. This parameter can be 
supplied on the CLINE or DEVICE macro or can be defaulted. 

int-address The device's (controller's) first or main interrupt address 
This parameter can be supplied on the CLINE or DEVICE macro 
or can be defaulted. 

line-id The identifier describing the communications line and 

modem configuration. Table 6-1 gives the values for this 
parameter. This parameter must be supplied on the CLINE 
or DEVICE macro. 

speed The Line speed expressed in Baud rate?. This parameter must 

be supplied on the CLINE or DEVICE macro. 
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DIB names are chosen by the user. These names must be assigned to Logical Units 
(LUNs) by the user in the Unit Assignment Table (UAT) . The application program will 
perform I/O to a given LUN, which should be assigned as the DIB name (dib-namel) for 
the appropriate Protocol Driver line. The Protocol Driver will perform I/O to the 
LUN specified by the user in the CLINE macro (device-lun). This user-supplied LUN 
should be assigned in the UAT to the appropriate Device Driver DIB for that line 
(dib-name2). 

Standard DIB names recommended are: 

/ 

DrCSnn for synchronous Device Driver Lines 
D:BSnn for BiSync Protocol Driver lines 

where nn are two digits unique to each line. The CLINE macro will prefix all user 
names with "D:". 

The standard convention for naming the LUN connecting the Protocol Driver to Device 
Driver DIB is to use an unsigned integer (<16384) plus 16384 (:4000). A macro (CLUN) 
parameter is available to generate such a LUN. The CLINE macro uses the CLUN macro. 
The <fevice-LUN parameter on the CLINE macro, therefore, should be an integer <16384. 
The user may use the CLUN macro in his UAT definition to generate the LUN values. 
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GLOSSARY 


asynchronous 

transmission 

channel 

circuit 


data link 


Transmission of data in which each character consists of data bits and 
start and stop bits; may be blank periods between characters. 

User view of the circuit configuration. 

The medium carrying the message; may be a line, cable, radio, micro- 
wave, or even just a pair of wires. 

A group of lines between two facilities; everything required to link 
two facilities including interface equipment and the transmission 
channel (line). 


full-duplex 

circuit 

haIf-duplex 
circuit 

modem 


multipoint 

system 


A circuit permitting simultaneous two-way communication. 


A circuit permitting two-way communication, one way at a time. 


A device that provides the interface between a telephone or any other 
form of communications line (analog) and a terminal or computer 
(digital) and does the necessary analog/digital conversion. 

A communications system having a central station with multiple tribu¬ 
tary stations, normally with nonswitched permanent data links; the 
central station selects and polls the tributaries. 


network 

nonswitched 

system 

point-to-point 

system 


The aggregate of all data links used by an organization. 

A communications system in which dedicated lines provide permanent 
connections between stations. 

A communications system in which only two stations are linked at a 
time; with a switched system, there may be multiple stations although 
only two can be linked at any one time. 
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polling 


protocols 

selection 


simplex 

circuit 

switched 

system 


synchronous 

transmission 


transparent 

mode 




A centrally controlled method of calling a number of transmitting 
stations (terminals) to permit them to transmit information; an 
invitation to send. 

Rules of procedure; the formats for packaging data for transmission. 

A request made by the central controller to receive a message from a 
transmitting station. 

A circuit permitting the transmission of data in only one direction. 


A communications system in which the data link is disconnected between 
transmissions and reestablished for each new transmission by standard 
dialing procedures (telephone link). 

Transmission of data bits only; no start or stop bits are present to 
synchronize each character; an entire block is synchronized and the 
incoming bits are counted to form a character; blank periods between 
characters in a block are limited. 

A convention in which all possible bit combinations can be used as 
data; none are regarded as control characters (unless distinguished by 
a leading escape character, such as DLE in BiSync). 
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APPENDIX B.l 


ASCII CHARACTER CODES 


CHARACTER 

ASCII CODE 

CHARACTER 

ASCII CODE 

Null 

00 

> greater 

3E 

Bell 

07 

p 

3F 

CR 

0D 

@ 

40 

LF 

0A 

A 

41 

blank 

20 

B 

42 

! exclamation 

21 

C 

43 

" quote 

22 

D 

44 

# 

23 

E 

45 

$ 

24 

F 

46 

% 

25 

G 

47 

& 

26 

H 

48 

1 apostrophe 

27 

I 

49 

( open paren. 

28 

J 

4A 

) close paren. 

29 

K 

4B 

* asterisk 

2A 

L 

4C 

+ 

2B 

M 

4D 

, comma 

2C 

N 

4E 

- minus 

2D 

0 

4F 

. period 

2E 

P 

50 

/ slash 

2F 

Q 

51 

0 zero 

30 

R 

52 

1 

31 

S 

53 

2 

32 

T 

54 

3 

33 

U 

55 

4 

34 

V 

56 

5 

35 

w 

57 

6 

36 

X 

58 

7 

37 

Y 

59 

8 

38 

Z 

5A 

9 

39 

[ open bracket 

5B 

: colon 

3A 

X back slash 

5C 

; semicolon 

3B 

] close bracket 

5D 

loss 

3c' 

f up arrow 

5E 

- equa 1 

3D 

— back arrow 

5F 



f< about' 

7K 


< 
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APPENDIX B.2 
EBCDEC CHARACTER CODES 


CHARACTER 

EBCDIC CODE 

CHARACTER 

EBCDEC CODE 

EBCDIC 






lower case 

Null 

. 00 

>greater 

6E 


Bell 

2F 

7 


6F 


CR 

0D 

@ 


7C 


LF 

25 

A 

a 

Cl 

61 

blank 

40 

B 

b 

C2 

62 

I exclamation 

5A 

C 

c 

C3 

63 

M quote 

7F 

D 

d 

C4 

64 

# 

7B 

E 

e 

C5 

65 

$ 

5B 

F 

f 

C6 

66 

% 

6C 

G 

g 

C7 

67 

& 

50 

H 

h 

C8 

68 

r apostrophe 

7D 

I 

i 

C9 

69 

(open paren. 

4D 

J 

j 

D1 

6A 

) close paren. 

5D 

K 

k 

D2 

6B 

* asterisk 

5C 

L 

1 

D3 

6C 

+ 

4E 

M 

m 

D4 

6D 

, comma 

6B 

N 

n 

D5 

6E 

- minus 

6D 

0 

o 

D6 

6F 

. period 

4B 

P 

P 

D7 

70 

/ slash 

61 

2 

q 

D8 

71 

0 zero 

F0 

R 

r 

D9 

72 

1 

FI 

S 

s 

E2 

73 

2 

F2 

T 

t 

E3 

74 

3 

F3 

U 

u 

E4 

75 

4 

F4 

V 

V 

E5 

76 

5 

F5 

w 

w 

E6 

• 77 

6 

F6 

X 

X 

E7 

78 

7 

F7 

Y 

y 

E8 

79 

8 

F8 

Z 

z 

E9 

7A 

9 

F9 

[ 

open bracket 

CO 


: colon 

7 A 

\ back slash 

E0 


; semicolon 

4i’ 

i 

close bracket 

DO 


le s s 

4C 

t 

up arrow 

4F ' 


= equal 

7 K 

— 

back arrow 

5F 




Rubout (DEL) 

07 
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APPENDIX C.l PROTOCOL DRIVER DEVICE INFORMATION BLOCK (DIB) 


WORD 


0 

CHAIN 

1 

DCIB 

2 

QUEQE 

3 

CN 

4 

DSW 

5 

DT 

6 

DCUN 

7 

DCTMR 

8 

DFLGS 

9 

DULS 

10 

DPFLGS 

11 

DBLKSZ 

12 

DLPARM 

13 

DIXLTR 

14 

DOXLTR 

15 

DLUN 

16 

DDIB 

17 

DSRTN 

18 

DTMPl 

19 

DTMP2 

20 

DCKSR 

21 

DCKSF 

22 

DCKSP 

23 

DCKSA 

24 

DHDRCT 

25-29 



Words 1-6 - Standard for IOX 


Word 7 - Input Character Timer 

Word 8 - Standard for IOX 


CONTENTS 

*DIB Chain Pointer 
*CIB Address 
COB Request Queue 
Coordination Number 
^Device Specification Word 
^Device Type 

Controller No./Unit No. 

Input Char. Timer Value 
^Function Codes 
*Max. Bytes - ASCII/Binary 
Protocol- and Device-Dependent Flags 
Block Size 
Line Parameters 
Input Translate Routine 
Output Translate Routine 
Device LUN 
Line DIB Chain 
Subroutine Return Address 
Temp. Cell 1 
Temp. Cell 2 

Checksum Routine Address 
Checksum Flags 
Checksum Polynomial 
Checksum Accumulation 
Header Byte Count 
Header Bytes 1-10 


Value 


Word 0 - S !«j r d I <>\ I uX 


*Standard for IOX 
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ford 10- Device-Dependent Flags 

The device-dependent flags are defined as follows: 


Bits 

Equate 

Definition 

0-7 

DDFLGS 

Device-dependent flags 

0 

DDFMAS 

Master station 

3 

DDFACU 

Auto-call this line 

8-15 

DPFLGS 

Protocol-dependent flags 

8 

DPFUWX 

Unformatted WRITES transparent 

9 

DPFAWX 

All WRITES transparent 

10 

DPFUSR 

User line control 

11 

DPFDIS 

Disconnect on Write File Mark 


Word 11- Maximum Block Size 


Word 12- Line Parameters 

The line parameters are: 


Bits 

0 

1 

2-3 


Equate Definition 

DLPPEN Parity enable 

DLPPSL Parity select, l=even 

DLPWSL Word length select, 00=5 bits per character, 

11=8 bits per character 


Word 13- Input Translate Routine Address 


Word 14- Output Translate Routine Address 


Word 15- Device Logical Unit Name/Number 


Word 16- Line DIB Chain 


Word 17- Device Driver Subroutine Return Address 


Word 18- Device Driver Temporary Cell 1 


Word 19- Device Driver Temporary Cell 2 


Word 20- Checksum Routine Address 
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Words 25-29- Header Bytes 1-10 
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APPENDIX C.2 PROTOCOL DRIVER CONTROLLER INFORMATION BLOCK (CIB) 


WORD 

0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 


CBOR 

CHAIN 0 

IDT,PRI 1 

ICUN,ITCB 2 

CN 3 

ILUN 4 

ISTA,IOP 5 

IRCNT 6 

IBUFF 7 

IACNT,ISTPTB 8 

IPCMR 9 

ICTMR 10 




CJTBL 





CPFLGS 

CPTBL 

EXCESS 

CLSTAT 

CIOB 

COP 

CRCNT 

CBUFF 

CTCNT 

CDAA 

CD IB 

CFLGS 


(Coni' 5 d) 


> 





I 

O 

B 


CONTENTS 

^Beginning of Request Flag 
Temp. Cell 
Device Type 
Device No. 

Coordination No. 

Device LUN 
Status Opcode 
Requested Count 
Buffer Address 

Actual Count /Stop Seq. Table Address 
Protocol Char Mod Routine Address 
Character Timer 

Unused by Protocol Driver 

*READ Entry 
*WRITE Entry 
^POSITION Entry 
*FUNCTION Entry 
*Special Operation Entry 
Protocol Driver Flags 
Protocol Driver Master Table 
*Caller IOB Word 8 - Prompt Chars 
Line Status 
*Caller IOB Address 

*Caller IOB Word 5 - Opcode, Status 

*Caller IOB Word 6 - Req. Count 

*Caller IOB Word 7 - Buffer Address 

*Actual Count 

*Caller IOB Word 9 

*Busy Flag (Current DIB Address) 

*DIB Word 8 


*Standard for IOX 
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Word 23-Line Status 

The line status is defined as follows: 

Bits E qua t e D efinition 


0 

CLSTDO 

Tran 

smit 

data 

overrun 



CLSTFK 

T 

ran 

;m i 1 

f ram 

inq error 


S 

CLSTTO 

T 

.in 

;in i 1 

1 i me* 

ail 


< > 

< 

!,< 


. d 

• h-.it 

to : a nd 

('TM 

7 


1/ 


<d 

data 

;<-l ready 

(d::i 

H 

Cl,BCD 

l,< 


ol 

car i i * 

*r did erd 

(CD) 

9 

CKSSTO 

•>l 

'K'C 

in 1 

timooi 

ii 
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Bit: 
" 10 
12 

14 

15 


Words 23 


Word 34- 


Word 35- 


Word 36- 


Word 37- 


Eq uat e 

CLSRTO 

CLSRFE 

CLSPE 

CLSRDO 


Del in.!. t:.M on 
Eocei )Jh i moon t 
keoei^ > f: \ uruing error 
Parity r * rro.r 
ReceJ data overran 


33 - Standard for IOX 


Current DIB Address for COMX 


Temporary 

Used as storage for user *s requested count and 

Tempo rary 

Used as storage for ir-cu 's c- s f fer address and 

Length of Protocol CM R - C\ ST-H-l 


subroutines. 


subroutines. 


rii/c -6 
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C.3 DEVICE DRIVER INPUT Cl* 


WORD 


0 

CBOR 

1 


2 


3 


4 


5 


6 

CINTSK 

7 

COTTSK 

8 


9 


10 


11 


12 


13 

CTIMER 

14 

CLIB 

15 

CJTBL 

16 


17 


18 


19 


20 

CINRTN 

21 

CDSRTN 

22 

CSTPTB 

23 

CLSTAT 

24 

CIOB 

25 

COP 

26 

CRCNT 

27 

CBUFF,CFUMP 

28 

CTCNT 

29 

CCMR 


(< ’out * d) 


CONTENTS 

Beg. of Request Flag/Input EOB 
Interrupt Address 

JST INTQS: 

DATA $ 

DATA 0 

DATA 0 

DATA 0 

DATA Input EOB Exit 

DATA PRIORITY 

DATA A REG 

DATA X REG (CIB Address) 

DATA P-LOC (CIB Address) 

LDX $+2 

JMP Input EOB Interrupt Routine 

Timer/Interrupt State Flag 
LIB Address 
*READ Entry 

*WRITE Entry (if Full Duplex , Unused - 
*Unused - 0 
^FUNCTION Entry 
*Unused - 0 

Input Interrupt Routine Address 
Subroutine Return Address 
*IOB Word 8 - Stop Seq. Table Address 
Line Error Status 
*Caller IOB Address 

*Caller IOB Word 5 - Opcode/ Status 
*Caller IOB Word 6 - Req. Count 
*Buffer Address/Function Parameter 
*Actual Count 

*IOB Word 9 - Char. Proc. Routine 

c 


‘Standard for FOX 
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WORD 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 


CDIB 

CFLGS 

STATUS 

CRTN 

CCHAIN 

CCCADR 

CCCHAR 

CTMP21 

CTMP22 

CSTPFG 

CXLTR 

CAEOR 

CINTBF 

CINTCT 

CCHMSK 

LDICIB,LDOCIB 


CONTENTS 

*Busy Flag (Current DIB Address) 

*DIB Word 8 
♦Status for EOR 
Return Address for CD:STO 
Device CIB Chain (DC::) 

Current Character Address 
Current Character (s) 

Temp Cell 1 
Temp Cell 2 

Stop Sequence Table Flags 
Translate Routine Address 
A Reg Returned to Caller at EOR 
Current Interrupt Buffer Address 
Additional Interrupt Byte Count 
Character Bit Mask 

Length of Input/Output CIB - CCHMSK+1 


Word 0 - Input End-of-Block Interrupt Address 


Words 1-12 - End-of-Block Interrupt Routine 
Word 13- Timer/Interrupt State Flag 


Word 14- Line Information Block Address 

Words 15-19 - Standard for IOX 

Word 20- Input Interrupt Routine Address 

Word 21- Device Driver Subroutine Return Address 

Word 22- Standard for IOX 
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Word 23- Line Error Status 

The line error status is defined as follows: 


Bits 

Equate 

Definition 

0 

CLSTDO 

Transmit data overrun 

3 

CLSTFE 

Transmit framing error/break detect 

5 

CLSTTO 

Transmit timeout 

6 

CLSCTS 

Loss of clear to send (CTS) 

7 

CLSDSR 

Loss of data set ready (DSR) 

8 

CLSCD 

Loss of carrier detect (CD) 

9 

CLSSTO 

Special timeout 

10 

CLSRTO 

Receive timeout 

12 

CLSRFE 

Receive framing error/invalid stop character 

14 

CLSPE 

Parity error 

15 

CLSRDO 

Receive data overrun 

24-32- 

Standard 

for IOX 


Word 33- Return Address for Device Driver Start Output Routine 

Word 34- Device CIB Chain 

Word 35- Current Character Address 

Word 36- Current Character(s) 

Words 37-38 - Temporary Cells 

Word 39- Stop Sequence Table Flags 

The stop table flags are defined as follows: 


Bits 

Equate 

0-7 

STPCNT 

10 

STPCKS 

11 

STPTSC 

12 

STPESF 

13 

STPECN 

14 

STPEPN 

15 

STP1ST 


Word 40- Translate Routine Address from Caller's DIB 

Word 41- A Register Returned to Caller at EOR 

Word 42- Current Interrupt Buffer Address 

Word 43- Additional Interrupt Byte Count 

Header and device-dependent characters added to message by Device Driver 

Word 44- Character Bit Mask 

Masks out invalid bits as determined by the line parameter word in the 
DIB. 

Word 45- Length of Cnput/Output CIB 
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APPENDIX C.4 


DEVICE DRIVER OUTPUT CIB 


WORD 



CONTENTS 

Beg. of Request Flag/Output EOB 
Interrupt Address 

JST INTQS: 

DATA $ 

DATA 0 

DATA 0 

DATA 0 

DATA Output EOB Exit 

DATA PRIORITY 

DATA A REG 

DATA X REG (CIB Address) 

DATA P-LOC (CIB Address) 

LDX $+2 

JMP Output EOB Interrupt Routine 

Same as Input CIB 


Word 0 - 

Words 1-12 - 

Words 13-45 - 


Output End-of-Block Interrupt Address 
Output End-of-Block Interrupt Routine 

Same as for Device Driver Input CIB 



J 
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C.5 LINE INFORMATION BLOCK (LIB) 


WORD 


0 

LSTNS 

1 

LSOFS 

2 

LDADR 

3 

LDFLG 

4 

LDRTBL 

5 

LICIB 

6 

LOCIB 

7 

LOBIR 

8 

LIINT 

9 

LOINT 

10 

LISIN 

11 

LIBFS 

12 

LIBFE 

13 

LOBFS 

14 

LOBUF 

15 

LOBCT 

16 

LFCIB 

17 

LFWCB 

18 

LLFUN 

19 

LHDWS 

20 

LLPARM 

21 

LLSDLY 

22 

LDDWDl 

23 

LDDWD2 

24 

LDDWD3 

25 

LPAD 

26 

LSPCH 

27 

LEXCPT 


CONTENTS 

Standard Line Status Word 

Software Line Status 

Device Address 

Device-Dependent Flags 

Device Transfer Vector 

Input CIB Address 

Output CIB Address 

Output EOB Interrupt Rtne Address 

Input Word Interrupt Location 

Output Word Interrupt Location 

Start Input Instruction 

Input Interrupt Buffer Start Addr, 

Input Interrupt Buffer End Addr. 

Output Device Buffer Address 
Output Interrupt Buffer Addr. 

Output Interrupt Byte Count 

Function Proc. Current CIB 

Function Proc. Next CIB 

Last Function Issued 

Last Hardware Status Word 

Current Line Parameter Word 

Line (Modem) Signal Delay 

Device-Dependent Word 1 

Device-Dependent Word 2 

Device-Dependent Word 3 

Pad Character Information 

SMC Sync/Special Character 

Exception Interrupt Point of Interrupt 
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Word 0 - Standard Line Status Word 

Line status is defined as follows: 

Bits Equate Definition 

0-5 LSTLSG Line signals 

0 LSTDSR Data set ready 

1 LSTCTS Clear to send 

2 LSTCD Carrier detect ^ 

3 LSTRI Ring indicator 

4 LSTg Signal quality 

5 LSTSCR Secondary channel receive 

6 LSTTFE Transmit framing error 

7 LSTRFE Receive framing error 

8 LSTPE Parity error 

9 LSTTDO Transmit data overrun 

10 LSTRDO Receive data overrun 

11 LSTSCD Secondary channel receive 

12 LSTDRD Data ready 

13 LSTTMT Transmitter empty 


Word 1 - Software Line Status 

Software line status is defined as follows: 


Bits 

Equate 

0 

LSFTM 

1 

LSFRM 

2 

LSFEM 

3 

LSFLB 

4 

LSFPDX 

5 

LSFLDX 

6 

LSFMTY 

7 

LSFANM 

8 

LSFCTY 

9 

LSFNCD 

12-13 

LSFCOD 

14 

LSFENL 

15 

LSFINT 


Word 2 - Device Address 


Definition 

Transmit mode/output active 
Receive mode/input active 
Echo mode 
Loop back mode 

Protocol duplex (0 = full, 1 = half) 

Line duplex (0 = full, 1 = half) 

Modem/controller type (0 = async, 1 = sync) 

Answer mode (0 = dedicated, 1 = switched) 

Carrier type (0 = constant, 1 = controlled) 

Carrier detect must be lowered before request to send 
is raised 

Line code set (00 = internal ASCII r 01 =■ USASCII, 

10 = EBCDIC) 

Line enabled (1 = enabled) 

Line initialized (1 = initialized) 


Word 3 - Device-Dependent Flags 

Word 4 - Device Transfer Vector 

Address of Device-Dependent-Routines Table* 

Word 5 - Input CIB Address 

Word 6 - Output CIB Address 

If half-duplex line, same as word 5 (i.e., only one CIB for both input 
and output). 

Word 7 - Output End-of-Block Interrupt Routine Address 

If full-display line, same as word 6 (output CIB address). 
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Word 8 - Input Word Interrupt Location 

Word 9 - Output Word Interrupt Location 

Word 10- Start Input Instruction 

Complete with device address (e.g. r AIN DA,1) 

Word 11- Input Interrupt Buffer Start Byte Address 

Word 12- Input Interrupt Buffer End Byte Address 

Word 13- Output Device Buffer Byte Address 

Word 14- Output Interrupt Buffer Byte Address 

Word 15- Output Interrupt Byte Count 

Word 16- FUNCTION Request Processing in Current CIB 

Word 17- FUNCTION Request Waiting for Processing in Next CIB 

Word 18- Last Function/Command Word to the Device 

Word 19- Last Hardware Status Word Input 
Status returned by device. 

Word 20- Current Line Parameter Word 

Same format as Line Parameter Word in Protocol Driver DIB. 

Word 21- Line (Modem) Signal Delay (in ticks) 

Word 22- Device-Dependent Word 1 

Device-Dependent factors are defined as follows: 


Bits 

Equate 

Definition 

0 

LDWDLE 

DLE seen 

13 

LDWRXP 

Receive in transparent mode 

14 

LDWTXP 

Transmit in transparent mode 

15 

LDWTMD 

Transmit modification 


Word 23- Device-Dependent Word 2 

Word 24- Device-Dependent Word 3 

Word 25- Pad Character Information 

Pad character information is defined as follows: 

Bits Equate Definition 

0-7 LPDCNT No. pad chars, to be sent 

8-15 LPDCHR The char, to be sent 

Word 26- SMC Sync/Special Character 

Word 27- Exception Interrupt Point of Interrupt 

Word 27 plus an additionaJ 24 words are used only if the device has 
exception interrupts (e.g., the SMC). 
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